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内 容 提要 
本 书 是 一 部 关于 Android 开发 的 基础 教程 ， 以 由 浅 入 深 、 循 序 渐进 的 方式 讲解 了 Android 程序 设计 的 核 
简单 的 





心 概念 和 技术 。 本 书 不 仅 结合 井 字 游戏 开发 案例 形象 生动 地 讲解 了 Android 生命 周期 、 月 
数据 存储 等 基础 知识 ， 而 且 还 深入 探讨 了 外 部 通信 、 基 于 位 置 的 服务 、 内 置 SQLite 数据 库 等 
章 最 后 都 提供 了 “快速 阅读 指南 ” 通过 它 可 以 迅速 找到 所 需 信 息 ， 并 高 效 地 完成 工作 。 
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Android 是 一 款 用 于 手机 和 平板 电脑 的 开源 操作 系统 ， 由 Google 及 其 合作 伙伴 和 其 他 参与 者 
开发 。 使 用 Android 的 手机 和 其 他 移动 设备 现 已 超过 10 亿 部 ， 这 让 它 占 据 了 头号 应 用 开发 平台 的 
宝座 。 无 论 你 是 业余 爱好 者 还 是 专业 程序 员 ， 无 论 你 从 事 Android 开 发 只 是 出 于 好 玩 还 是 为 了 赚 
钱 ， 都 需要 更 深入 地 学 习 。 本 书 旨 在 帮助 你 起 步 。 
































Android 的 独特 之 处 


市 面 上 的 其 他 移动 平台 还 有 很 多 ,包括 iOS、Windows 、Tizen 、Firefox OS 等 。 为 何 大 家 会 选 
择 Android? 它 有 什么 独特 之 处 呢 ? 


虽然 Android 的 一 些 功 能 并 不 新 颖 ， 但 它 是 第 一 个 兼 具 如 下 特点 的 环境 。 


口 基于 Linux 的 免费 开源 平台 : 手机 制造 商 对 其 钟爱 有 加 ， 因 为 他 们 可 以 对 这 个 平台 进行 定 
制 ， 而 无 需 支 付 版 权 费 。 开 发 人 员 也 喜欢 它 ， 因 为 他 们 知道 这 个 平台 不 受制 于 任何 可 能 
破产 或 被 收购 的 厂商 。 

口 基于 组 件 的 架构 ( 其 灵感 来 自 于 Internet 混 搭 技术 ) : 能 够 以 不 同 于 开发 人 员 最 初 设想 的 
方式 使 用 应 用 的 组 成 部 分 ， 甚 至 可 以 将 内 置 组件 替 换 为 改进 版 本 。 这 在 移动 领域 发 起 了 
新 一 轮 的 创意 运动 。 

口 大 量 现 成 的 服务 : 基于 位 置 的 服务 使 用 GPS 或 基站 三 角 学 定位 , 让 你 能 够 根据 设备 位 置 定 
制 用 户 体 验 。 五 脏 俱 全 的 SQL 数据 库 能 够 让 你 好 好 地 利用 本 地 存储 , 设备 只 需 时 不 时 地 联 
网 同步 即 可 。 浏 览 器 和 地 图 视图 可 以 直接 能 和 人 到 应 用 中 。 这 些 功能 都 能 使 应 用 的 功能 得 
到 进一步 的 提升 ， 同 时 还 降低 了 开发 成 本 。 

口 自动 管理 应 用 的 生命 周期 : 多 重 安全 保障 能 够 将 程序 彼此 隔离 ， 从 而 提高 了 系统 的 稳定 
性 。 最 终 用 户 不 必 关 心 哪些 应 用 处 于 活动 状态 ， 也 无 需 关 闭 一 些 程序 以 便 运 行 其 他 程序 。 
Android 针 对 电量 和 内 存 有 限 的 设备 进行 了 彻底 优化 ， 这 是 以 前 的 平台 没有 尝试 过 的 。 

口 高 品质 图 形 和 声音 : 流畅 而 平滑 的 2D 和 3D 加 速 图 形 支持 新 的 游戏 和 商业 应 用 。 内 置 的 编 

码 /解码 器 支持 常见 的 行业 标准 音频 和 视频 格式 ， 包 括 H.264 ( AVC )、MP3 和 AAC。 

口 到 各 种 既 有 和 未 来 硬件 的 移植 性 : 所 有 程序 都 使 用 Java 编 写 ， 并 由 Android 的 ART 预 先 编 
译 器 或 Dalvik 虚 拟 机 执行 ， 因 此 代码 可 移植 到 ARM、x86 和 其 他 体系 结构 。 支 持 各 种 输入 
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方法 ， 如 键盘 、 游 戏 手 柄 、 和 触摸 、 电 视 迁 控 、 鼠 标 和 跟踪 球 。 可 针对 任何 屏幕 分 辩 率 和 
朝向 定制 用 户 界面。 
Android 在 移动 应 用 与 用 户 交 互 方面 进行 了 新 的 尝试 ， 并 为 这 种 交互 提供 了 技术 支持 。 但 
在 整个 Android 生 态 系 统 中 ， 最 重要 的 还 是 开发 人 员 为 之 编写 的 软件 。 本 书 将 帮助 你 在 这 方面 
开 好 头 。 



































针对 的 读者 


本 书 是 为 想 快速 熟悉 Android 平 台 的 新 手 编写 的 。 只 需 儿 分 钟 ， 你 就 能 安装 好 开发 工具 并 编 
写 第 一 个 程序 。 阅 读 完 本 书后 ,你 将 能 够 编写 引人入胜 的 完整 应 用 。 更 重要 的 是 ,你 将 能 够 找到 
并 看 懂 Android 开 发 旅程 中 所 需要 的 高 级 材料 。 

要 阅读 本 书 ， 你 必须 明白 基本 的 Java 编 程 概念 ， 如 类 、 方 法 、 作 用 域 和 继承 ， 还 必须 知道 
import、static、final 、public 和 this 等 Java 关 键 字 的 含义 。 如 果 你 不 明白 我 在 说 什么 ， 建 
议 先 阅读 一 本 Java 入 门 书 ， 如 : 

口 Java Precisely [Ses05] 

口 《Head First Java ( 中 文 版 )》( Head First Java ) [SB05] 

口 《Effective Java 中 文 版 》( Effective Java ) [Blo08] 

口 《Java 程 序 设计 语言 》( The Java Programming Language ) [AGH05] 
口 《Java 技 术 手 册 (第 6 版 )》( Java in a Nutshell ) [EF14] 

你 不 需要 具备 任何 移动 设备 软件 开发 经 验 。 实 际 上 ， 如果 你 有 这 样 的 经 验 ， 最 好 将 其 抛 诸 脑 
后 , 因为 Android 是 如 此 地 与 众 不 同 , 刚 接触 它 时 最 好 是 没有 任何 的 成 见 。 然 而 , 如 果 你 具备 IntelliJ 
IDEA 、Eclipse 或 Visual Studio 等 集成 开发 环境 (IDE ) 的 使 用 经 验 ， 这 些 经 验 将 派 上 用 场 。 

























































































涵盖 的 内 容 


本 书 分 为 四 大 部 分 ， 大 致 是 按 从 简单 主题 到 复杂 主题 ， 或 者 说 从 Android 常 见方 面 到 不 那么 
常见 的 方面 来 安排 的 。 

我 们 利用 几 章 的 篇 幅 开 发 了 一 个 示例 : Android 终 极 版 井 字 棋 游戏 。 通 过 逐渐 给 这 个 游戏 添 
加 功能 ， 你 将 学 习 Android 编 程 的 很 多 方面 ， 包 括 用 户 界面 、 多 媒体 以 及 Android 活 动 和 片段 的 生 
命 周 期 。 
第 一 部 分 首先 将 简要 地 介绍 Android， 你 将 学 习 如 何 安装 Android 模 拟 器 以 及 如 何 使 用 IDE 来 
编写 第 一 个 程序 。 接 下 来 将 介绍 几 个 重要 的 概念 ， 如 Android 应 用 的 生命 周期 。Android 编 程 与 你 
习惯 的 方式 稍 有 不 同 ， 请 务必 掌握 这 些 概念 后 再 接着 往 下 阅读 。 
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第 二 部 分 讨论 Android 用 户 界 面 : 显示 、 输 入 、 多 媒体 和 动画 。 你 编写 的 很 多 程序 都 将 用 到 
这 些 功 能 。 

第 三 部 分 更 深入 地 探讨 Android 平 台 ， 包括 如 何 让 应 用 与 多 种 Android 设 备 和 版 本 兼容 ， 以 及 
如 何 将 应 用 发 布 到 Google Play Store。 

第 四 部 分 讨论 一 些 较 高 级 的 主题 ,包括 相 和 人 HTML 页 面 、 访 问 Web 服 务 、 使 用 Google Play 服 
务 以 及 使 用 内 置 的 SQLite 数 据 库存 储 数 据 。 


本 书 的 最 后 是 附录 和 参考 文献 。 其 中 ， 附 录 介 绍 了 Android 和 Java Standard Edition ( SE) 的 
差别 。 



































新 增 内 容 


本 版 经 过 了 修订 ， 以 支持 Android 4.1 到 Android $.1 的 所 有 版 本 。 本 书 所 说 的 Android“ 现 代 ” 
版 ， 指 的 是 Android 4.1 (Jelly Bean ) 和 更 高 版 。 





旧版 本 


Android 2.3( Gingerbread ) 是 最 后 一 个 只 支持 手机 的 版 本 。Android 3.0 ( Honeycomb ) 是 重要 
的 分 水 岭 ， 但 只 支持 平板 电脑 ， 因 此 采用 它 的 设备 十 分 有 限 (但 在 Google 内 部 所 处 的 地 位 无 疑 是 
最 高 的 )、Android 4.0( Ice Cream Sandwich ) 同时 支持 手机 和 平板 电脑 ， 但 几乎 没有 在 Android 3.0 
的 基础 上 新 增 任 何 功 能 。 












































Android 4.1 的 新 特性 


在 Android 4.1 中 ，Google 为 改善 可 用 性 和 性 能 做 了 很 大 努力 。 这 个 计划 的 代号 为 Project 
Butter。Google 添 加 了 测量 系统 速度 和 效率 的 新 方法 ， 进 而 优化 了 处 理 时 间 的 使 用 效率 ”。 




















Android 4.2 的 新 特性 


Android 4.1 取 得 了 巨大 成 功 。 受 此 鼓励 , Google 决 定 在 接 下 来 的 两 个 版 本 中 保留 原来 的 代号 。 
Android 4.2( Jelly Bean MR1 ) 在 改善 性 能 的 道路 上 继续 前 行 ， 同 时 还 新 增 了 多 用 户 支 持 、 使 用 
Miracast 标 准 以 无 线 方式 将 屏幕 投射 到 远程 显示 器 的 功能 ”。 














QD http://d.android.com/sdk/api_diff/16/changes.html 
©® http://d.android.com/sdk/api_diff/17/changes.html 
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Android 4.3 的 新 特性 

Android 4.3( Jelly Bean MR2 ) 的 重点 是 安全 性 。 它 将 SE ( Security Enhanced ) Linux 作 为 底 
屋 操作 系统 ， 并 新 增 了 权限 设置 ( restricted profile ) 功能 ， 让 设备 所 有 者 能 够 给 不 同 用 户 设 置 不 
同 的 权限 。 它 还 是 第 一 个 支持 OpenGL ES 3.0 的 版 本 ”。 














Android 4.4 的 新 特性 


在 Android4.4 (KitKat ) 中 ,最 重要 的 新 特性 是 ， 将 基于 WebKit 的 WebView 替 换 成 了 Chrome 
浏览 器 ?使 用 的 Chromium 引 人 擎 。 





Android 4.4W 的 新 特性 


Android Wear ( KitKat for Watches ) 是 用 于 智能 手表 的 操作 系统 ， 为 支持 可 穿戴 设备 ”， 必 须 
做 一 些 修改 和 修复 。 





Android 5.0 的 新 特性 


Android 5.0 (Lollipop ) 最 显著 的 变化 是 引入 了 一 种 新 的 设计 语言 一 一 Material Design。 在 内 
部 ， 之 前 所 有 版 本 都 使 用 的 Dalvik VM 被 替换 为 了 ART。ART 依 靠 提 前 编译 来 改善 性 能 。 最 后 ， 
开启 了 Project Volta 计 划 ”“， 其 目标 与 Project Butter 相 同 ， 但 旨 在 延长 电池 的 续航 时 间 ， 而 不 是 改 
善 性 能 。 





























Android 5.1 的 新 特性 

Android 5.1 ( Lollipop MR1 ) 支持 多 个 SIM 卡 ， 新 增 了 通过 Google Play 分 发 运营 商 应 用 的 功 
能 。 另 外 ， 据 弃 了 AndroidHttpCLient 类 以 及 org.apache.http 包 中 大 量 的 类 =。 

如 果 我 没 记 错 , L 后 面 是 M、N、O 和 P。 只 要 采纳 本 书 的 建议 , 你 所 编写 的 程序 只 需 做 少量 修 
改 ( 甚 至 无 需 修改 )， 就 能 支持 未 来 的 Android 版 本 。 第 8 章 介 绍 了 如 何 创建 支持 多 个 版 本 的 程序 。 

要 了 解 各 种 Android 版 本 的 最 新 市 场 份额 ， 请 参阅 Android Device Dashboard"。 本 书 的 所 有 示 
例 都 针对 Android 4.1~5.1 版 进行 了 测试 。 
























































GD http://d.android.com/sdk/api_diff/18/changes.html 
© http://d.android.com/sdk/api_diff/19/changes.html 
G@) http://d.android.com/sdk/api_diff/20/changes.html 
(@ http://d.android.com/sdk/api_diff/21/changes.html 
© http://d.android.com/sdk/api_diff/22/changes.html 
(© http://d.android.com/resources/dashboard/platform-versions.html 
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本 书 不 支持 Android 4.1 之 前 的 版 本 ， 因 为 它们 占据 的 市 场 份额 很 小 并 且 还 在 不 断 鞭 缩 。 本 书 
也 没有 过 多 考虑 Android $.1 支 持 的 自 定 义 ， 因 为 编写 本 书 时 ， 使 用 Android 5.1 的 设备 还 不 多 。 为 
确保 短小 精 悍 ， 本 书 只 探讨 大 多 数 Android 程 序 都 涉及 的 主题 。 




















在 线 资源 
本 书 的 配套 网 站 "提供 了 如 下 资源 。 


口 本 书 所 有 示例 程序 的 完整 源 代 码 以 及 声音 和 图 像 等 资源 。 
口 列 出 本 版 错误 的 勘误 表 ( 但 愿 它 始终 是 空 的 )。 
口 让 你 能 够 直接 与 作者 和 其 他 Android 开 发 人 员 交 流 的 论坛 (但 愿 它 内 容 多 多 )。 


只 要 你 觉得 合适 , 可 以 在 你 的 应 用 中 随便 使 用 这 些 源 代码 。 请 注意 , 如 果 你 阅读 的 是 电子 书 ， 
也 可 以 单 击 代码 清单 前 面 的 三 角形 来 直接 下 载 源 代 码 文件 。 
































快速 阅读 指南 

大 多 数 作者 都 希望 读者 逐 字 阅读 其 著作 , 但 我 知道 你 不 会 这 样 做 , 你 只 想 学 习 完 成 手头 任务 
所 需 的 知识 ,等 以 后 需要 完成 其 他 任务 时 ， 再 回 过 头 来 阅读 相关 的 内 容 。 有 鉴于 此 , 我 尽力 提供 
了 相关 帮助 ， 以 免 你 迷路 。 

本 书 每 章 都 以 “快速 阅读 指南 ”结束 ， 为 下 一 章 的 内 容 提供 了 指南 ,让 你 在 不 按 顺序 阅读 时 
知道 接 下 来 该 阅读 的 内 容 ; 同时 还 列 出 了 图 书 和 在 线 文 档 等 其 他 资源 , 让 你 能 够 更 深入 地 了 解 相 
关 的 主题 。 

现在 就 开始 阅读 吧 。 第 1 章 将 引导 你 动手 创建 一 个 非常 简单 的 Android 程 序 ; 第 2 章 则 会 回 过 
头 来 介绍 Android 基 本 概念 和 理念 ; 第 3 章 将 介绍 一 个 井 字 棋 示例 ， 并 深入 探讨 用 户 界 面 一 一 大 多 
数 Android 程 序 最 重要 的 部 分 。 

你 的 终极 目标 是 ， 将 应 用 提交 到 Play Store 进 行销 售 或 供 人 免费 下 载 ， 因 此 第 9 章 将 演示 如 何 
完成 这 个 最 后 的 步骤 。 












































CD http://pragprog.com/book/eband4 
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Android 是 一 种 激动 人 心 的 开源 移动 平台 ， 它 像 手 机 一 样 无 处 不 在 ， 得 到 了 Google 以 及 其 他 
一 些 开 放手 机 联盟 成 员 ( 如 三 星 、HTC、 中 国 移动 、Verizon 和 AT&T 等 ) 的 支持 ， 因 而 不 能 不 加 
以 学 习 ， 否 则 你 承担 不 起 为 此 付出 的 代价 。 

好 在 Android 开 发 人 门 很 容易 ， 即 使 没有 Android 手 机 都 没关系 ， 只 和 需 有 一 台 可 供 安 装 Android 
SDK 和 设备 模拟 器 的 计算 机 即 可 。 

本 章 首先 介绍 如 何 安装 所 有 的 开发 工具 ， 然 后 再 创建 一 个 可 运行 的 应 用 一 -Android 版 
“Hello, World”。 如 果 你 并 非 Android 新 手 ， 那 么 可 以 快速 浏览 本 章 , 也 可 跳 过 本 章 ， 直 接 进 入 第 
2 章 。 




















1.1 安装 工具 


Android 软 件 开 发 包 (SDK ) 适用 于 Windows 、Linux 和 Mac OS 义 ， 使 用 它 开发 的 应 用 可 部 署 
到 任何 Android 设 备 。 


要 进行 Android 开 发 ， 必 须 先 安 装 Java、IDE 和 Android SDK。 


1.1.1 Java 开 发 包 7.0+ 


首先 ， 需要 安装 Java 开 发 包 (JDK )。 所 有 Android 开 发 工具 都 需要 它 ， 在 编写 程序 时 将 使 用 
Java 语 言 。 要 求 安装 JDK 7 或 8。 








注意 Mac 用 户 可 跳 过 这 一 小 节 ， 因 为 Android Studio 会 自动 安装 合适 的 JDK 版 本 ( 如 果 你 没有 
安装 的 话 )。 然而， 有 人 提出 ， 在 Mac 上 存在 JDK 版 本 不 匹配 的 问题 。 如 果 你 遇 到 了 错误 ， 
可 参阅 Stack Overflow 网 站 "的 故障 排除 技巧 ”。 








QD http://stackoverflow.com/questions/24472020 
© http://stackoverflow.com/questions/16636146 
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仅 安装 Java 运 行 环境 ( JRE ) 还 不 够 ， 还 必须 安装 完整 的 Java 开 发 包 。 建 议 从 Oracle 下 载 网 站 " a 
下 载 最 新 的 Java SE 8 JDK 进 行 更 新 。 


还 需 设置 环境 变量 JAVA_HOME， 使 其 指向 JDK 安 装 位 置 。 具 体 如 何 设置 取决 于 所 使 用 的 操作 
系统 。 例如， 在 Windows 7 中 ， 可 以 单 击 “ 开 始 ” 按 钮 ， 右 击 “ 计 算 机 ”并 选择 “属性 ”， 再 单 击 
“高 级 系统 设置 ”， 然 后 单 击 “ 环 境 变 量 ” 按 钮 ， 再 单 击 “系列 变量 ”列表 下 方 的 “新 建 ” 按 钮 ， 
然后 在 “变量 名 ”文本 框 中 输入 JAVA_HOME， 并 在 “变量 值 ”文本 框 中 输入 JDK 安 装 目录 。 最 
后 ， 单 击 “ 确 定 ”按钮 关闭 所 有 的 窗口 并 保存 设置 。 


要 核实 JDK 版 本 是 否 正确 无 误 ， 可 打开 一 个 shell 窗 口 (在 Windows 中 ， 要 打开 shell 窗 口 ， 可 
单 击 “开始 ”按钮 ， 输 入 cmd 并 按 回 车 键 )， 并 执行 如 下 命令 。 后 面 是 我 执行 这 些 命令 时 得 到 的 
输出 : 

C:\> java -version 

java version "1.8.0 31" 


Java(TM) SE Runtime Environment (build 1.8.0 31-b13) 
Java HotSpot(TM) 64-Bit Server VM (build 25.31-b07, mixed mode) 













































































C:\> echo %JAVA HOMES 
C:\Program Files\Java\jdk1.8.0 31 


你 应 看 到 类 似 的 输出 ， 其 中 的 版 本 号 为 1.7 或 更 高 。 





1.1.2 Android Studio 


接 下 来 ， 需 要 安装 Java 开 发 环境 ( 如 果 还 没有 安装 的 话 )。 建 议 使 用 Android Studio， 因 为 它 
是 免费 的 ， 并 得 到 了 打造 Android 的 Google 开 发 人 员 的 采用 和 支持 。 


务必 使 用 最 新 的 beta 版 或 生产 版 。 请 访问 Android Studio 下 载 页 面 >, 并 单 击 Download Android 
Studio 按 钮 。 


























注意 ”如果 不想 使 用 Android Studio( 大 千 世 界 什 么 人 都 有 ), 也 可 使 用 NetBeans 和 Eclipse 等 IDE， 
Se 支持 。 如 果 你 非常 老 派 ， 根 本 不 想 使 用 [DE， 也 可 只 使 用 命令 行 工 
。 本 书 假设 你 使 用 的 是 Android Studio ， 如 果 不 是 这 样 ， 就 需要 做 必要 的 调整 








QD http:/www.oracle.com/technetwork/java/javase/downloads 
©® http://d.android.com/sdk 
@ http://d.android.com/tools/help 
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4 第 1 章 快速 入 门 





Eclipse 怎么 了 ? 

直到 最 近 ， 大 部 分 Android 开 发 人 员 使 用 的 依然 是 Eclipse IDE 和 Android Development 
Tools。2013 年 5 月 ，Google 推 出 了 Android Studio 一 款 新 的 开发 环境 ， 它 基于 JetBrains 开 
发 的 IntelliJ IDEA?”。 

Android Studio 的 最 大 不 同 在 于 ,， 它 使 用 的 是 Gradle 编 译 系统 。Android Studio 还 提供 了 很 
多 新 功能 ， 如 经 过 重大 改进 的 WYSIWYG 编 辑 器 、 支 持 使 用 相同 代码 生成 多 种 配置 。Eclipse 
依然 得 到 了 支持 ， 但 大 多 数 新 开发 都 将 在 Android Studio 中 进行 。 








1. http://www.eclipse.org 
2. http://www.jetbrains.com/idea 





下 载 并 安装 Android Studio 后 ， 启 动 它 ， 并 按 屏幕 指示 进行 操作 。 对 于 所 有 设置 ， 都 接受 点 
认 的 标准 值 ， 即 不 断 地 单 击 Next 按 钮 ， 并 最 终 单 击 Finish 按 钮 。 下 载 并 安装 所 需 的 一 切 可 能 需要 
几 分 钟 ， 最 终 你 将 看 到 图 1-1 所 示 的 界面 。 

于 Android studioSetu EPE 

















Welcome to Android Studio 
人 


Recent projects Quick Start 








| 杞 Start a new Android Studio project N 





| Open an existing Android Studio project 


No Project Open Vet 图 Jmportan Android codesample 
Check out project from Version Control 
名 Import Non-Android Studio project 


者 Configure 


[Es# Docs and How-Tos 








Android Studio 101 Build 135.1641136. Check for updates now- 








图 1-1 
这 意味 着 已 经 成 功 地 安装 了 Android Studio， 可 以 开始 开发 了 。 
别 忘 了 ，Android Studio 在 不 断 地 发 展 变化 ， 因 此 你 看 到 的 界面 可 能 会 与 本 书 所 展示 的 稍 有 
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不 同 。 在 新 版 本 中 ， 默认 文件 名 和 目录 也 可 能 不 同 。 如 果 直 到 这 样 的 差别 ， 请 相应 地 调整 操作 ， 
并 报告 到 本 书 的 在 线 论坛 ”。 








真是 讨厌 ! 好 在 你 只 需 这 样 做 一 次 。 现 在 万 事 俱 备 ， 是 时 候 编写 第 一 个 程序 了 。 


1.2 创建 第 一 个 程序 

Android Studio 自 带 了 多 个 示例 程序 ， 即 模板 。 下 面 使 用 其 中 一 个 模板 来 创建 一 个 简单 的 
“Hello, Android” 程 序 。 这 只 需 几 秒 钟 就 能 完成 。 请 准备 秒表 。 准 备 好 了 吗 ? 出 发 ! 

选择 Start a new Android Studio project， 打 开 New Project 对 话 框 。 

将 依次 出 现 4 个 界面 。 其 中 ， 第 一 个 界面 要 求 给 出 应 用 的 名 称 和 存储 位 置 ， 如 图 1-2 所 示 。 





New Project 
Android Studio 


Configure your new project 


Application name | Hello Android 


Company Domain: | example.org 














Packagename: org.example.helloandroid 








Project location: Ci\Users\Ed\AndroidStudioProjects\HelloAndroid 














将 应 用 名 设置 为 Hello Android， 并 将 公司 域名 设置 为 example.org，Android Studio 会 自动 填写 
其 他 内 容 。 单 击 Next 按 钮 继续 执行 。 


第 二 个 界面 提示 指定 适用 的 Android 版 本 ， 如 图 1-3 所 示 。 





CD http://pragprog.com/book/eband4 
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New Project 
Android Studio 


Select the form factors your app will run on 


Different platforms require separate SDKs 


[MV] Phone and Tablet 





Minimum SDK API16: Android 4.1 (Jelly Bean) 





Lower APl levels target more devices but have fewer features available. By 
targeting ApI16 and later, your app will run on approximately 78.3% of the 
devices that are active on the Google Play Store. Help me choose. 


Ow 


Minimum SDK 

















Wear 








Minimum SDK 





DD Glass (Not Installed) 





Minimum SDK 




















选择 复 选 框 Phone and Tablet， 并 将 Minimum SDK 指 定 为 API 16: Android 4.1 (Jelly Bean)。 这 
一 步 很 重要 ， 请 务必 确保 选择 了 正确 的 版 本 。 接 下 来 ， 单 击 Next 按 钮 。 


第 三 个 界面 要 求 选择 要 添加 的 示例 活动 的 类 型 ， 如 图 1-4 所 示 。 








Add an activity to Mobile 


Add No Activity 


Blank Activity 








Fullscreen Activity 











Cance] | Finish | 
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选择 Blank Activity with Fragment， 并 单 击 Next 按 钮 。 
最 后 一 个 界面 要 求 指 定 活动 名 和 其 他 信息 ， 如 图 1-5 所 示 。 
eter ,OO I 去 9 le 


中 
| 











Choose options for your new file 


Creates a new blank activity, with an action bar and a 


contained Fragment. 
[| 


_ 


Activity Name: HelloActivity 





Layout Name: activity_hello 














Title: HelloActivity 








Menu Resource Name: «| menu_hello 








1 
1 
1 
1 Fragment Layout Name | fragment_hello 
1 
1 





| Blank Activity with Fragment 








The name of the activity class to create 


[Brevious | | Next | | Cancel | EEN 














图 1-5 

将 活动 名 ( Activity Name ) 改 为 HelloActivity， 其 他 内 容 将 自动 被 填写 完成 。 

在 本 书后 面 的 示例 中 ， 为 了 节省 时 间 ， 我 们 将 采用 如 下 简化 方式 指出 这 些 新 建 项 目 设置 。 
口 应 用 名 : Hello Android 

口 公司 域名 : example.org 

口 尺寸 : Phone and Tablet 

口 最 低 SDK: API 16, Android 4.1 (Jelly Bean) 

口 添加 活动 : Blank Activity with Fragment 

口 活动 名 : HelloActivity 


填写 完 最 后 一 个 界面 中 的 相关 内 容 后 , 单 击 Finish 按 钮 。IDE 将 创建 指定 的 项 目 , 其 中 包含 一 
些 默认 文件 。 接 下 来 ，IDE 将 对 其 进行 编译 和 打包 ， 为 执行 做 好 准备 。 

















注意 ”在 显示 fragment hello.xml 的 编辑 器 中 ， 如 果 出 现 了 有 关 泻 染 问题 (Rendering Problems ) 
的 错误 消息 ， 不 用 管 它 ， 只 需 将 窗口 关闭 即 可 。 这 是 Android Studio 中 一 个 已 知 的 bug。 

















向 导 将 程序 编写 好 了 ， 你 需要 做 的 只 是 尝试 运行 它 。 下 面 ， 首 先 在 Android 模 拟 需 中 运行 它 。 
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1.3 在 Android 模拟 器 中 运行 
模拟 器 是 一 个 程序 ， 它 运行 在 一 种 硬件 上 ， 却 可 以 模拟 另 一 种 硬件 。 使 用 Android 模 拟 器 ， 
几乎 可 在 台式 机 上 创建 任何 平板 电脑 、 手 机 和 可 穿戴 设备 的 虚拟 版 本 。 


要 运行 Android 程 序 ， 可 选择 菜单 Run>Run'app'， 也 可 单 击 工具 栏 上 的 Run 按 钮 ， 如 图 1-6 
所 示 。 





ze Refactor Build Run Run 'app' (Shift+Fl0) W Help 


【| 中 | 堪 EM 久 民 | 蛙 芭 首 党 |? 
main ) Cares ) 加 layout ) GS fragmeni helloxml ) 


图 1-6 
过 一 会 儿 后 ， 将 出 现 Choose Device 对 话 框 ， 如 图 1-7 所 示 。 














£6 
两 Choose Device 


OO Choosea running device 


Device Serial Number | State |,,, 





Nothing to show 


@®) Launch emulator 





Android virtual device: | Nexus5 API21 x86 | | 了 





[DD Use same deviceforfuture launches 








mm 


图 1-7 
确定 选择 了 Launch emulator， 并 指定 了 Android 虚 拟 设备 ( AVD ) 的 名 称 。 单 击 OK 按 钮 ， 运 
行程 序 。 
将 打开 Android 模 拟 需 窗口 并 启动 Android 操 作 系统 。 首 次 这 样 做 时 ， 这 可 能 需要 一 两 分 钟 ， 
请 耐心 等 待 。 如 果 屏 幕 被 锁定 ， 请 按说 明 轻 扫 鼠 标 以 解锁 。 


Android Studio 将 程序 的 副本 发 送 给 模拟 器 并 执行 它 。 此 时 将 出 现 应 用 界面 ， 这 说 明 “Hello， 
Android” 程 序 正在 运行 ， 如 图 1-8 所 示 。 
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A 


Hello Android 


Hello world! 





图 1-8 


如 果 几 分 钟 后 模拟 器 还 没有 出 现 , 或 者 看 起 来 像 停止 了 一 样 ， 可 能 是 由 于 你 的 计算 机 不 与 
Intel 硬 件 加 速 兼容 。 为 解决 这 种 问题 ， 可 新 建 一 个 AVD ， 并 指定 ARM 处 理 器 而 不 是 Intelx86。 更 
详细 的 信息 请 参阅 8.1 节 。 另 一 种 解决 方案 是 使 用 Genymotion 模 拟 器 "。 


就 这 么 简单 ! 祝贺 你 编写 了 第 一 个 Android 程 序 。 



































1.4 在 实际 设备 上 运行 


在 开发 期 间 ， 要 在 物理 设备 ( 如 Nexus 5 ) 上 运行 Android 程 序 。 做 法 几乎 与 在 模拟 器 中 运行 
十 相同 。 在 使 用 Android 4.2 或 更 高 版 本 的 设备 中 ， 需 要 先 启用 开发 者 模式 ， 即 启动 应 用 “设置 ”， 
再 选择 “关于 手机 ”或 “关于 平板 电脑 ”， 然 后 轻 按 “版 本 号 ”7 次 〈 这 是 Android 开 发 者 提供 的 

一 个 复活 节 彩 蛋 ); 之 后 再 启用 USB 调 试 ， 即 依次 选择 “开发 者 选项 ”> “调试 ”> “USB 调 试 ”。 


在 计算 机 上 安装 Android USB 设 备 驱 动 程序 ( 如 果 没 有 安装 的 话 ， 仅 Windows 系 统 需 要 这 样 
做 )， 然 后 使 用 设备 自 带 的 USB 电 缆 将 设备 连接 到 计算 机 。 

















| 

































































QD http:/www.genymotion.com 
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首次 安装 USB 驱 动 程序 时 可 能 比较 环 手 。Using Hardware Devices 页 面 "提供 了 最 新 的 设备 驱 
动 程序 及 其 安装 说 明 。 如 果 出 现 一 个 消息 框 ， 询问 是 否 允 许 USB 调 试 ( 其 中 还 显示 了 你 的 计算 机 
的 RSA 密 钥 指纹 )， 请 选择 复 选 框 Always allow from this computer， 表 单 击 OK 按钮 。 

以 后 再 运行 应 用 时 ,该 设备 将 出 现在 Choose Device 窗 口中 ,可 以 同时 运行 多 个 模拟 器 和 设备 ， 
并 在 每 次 运行 应 用 时 都 选择 要 使 用 的 设备 或 模拟 器 ; 也 可 以 选择 复 选 栓 Use same device for future 
launches。 如 果 设 备 没有 出 现在 列表 中 ， 通 党 意味 着 ， 要 么 USB 驱 动 程序 有 问题 ， 要 么 针对 的 
Android 版 本 不 对 。 


应 用 准备 就 绪 后 ， 要 将 其 发 布 给 其 他 人 使 用 。 这 需要 执行 一 些 额外 的 步骤 ,将 在 第 9 章 进 行 
详细 介绍 。 

































































缩短 周转 时 间 


启动 模拟 器 需要 很 长 时 间 。 可 以 这 样 想 象 一 下 : 开启 手机 时 ， 它 需要 像 其 他 任何 计算 机 
系统 一 样 启动 ， 而 关闭 模拟 器 就 像 是 关闭 手机 并 取出 电池 一 样 。 因 此 ， 请 不 要 关闭 模拟 器 ! 


在 Android Studio 运 行 期 间 ， 应 始终 打开 模拟 器 窗口 。 这 样 ， 下 次 启动 Android 程 序 时 ， 
Android Studio 将 注意 到 模拟 器 正在 运行 ， 因 此 只 需要 将 程序 发 送 给 它 去 运行 即 可 。 


1.5 其 他 步骤 
为 节省 时 间 ， 前 面 省 略 了 两 个 步骤， 下 面 来 对 其 加 以 介绍 。 


1.5.1 检查 更 新 
Android Studio 还 不 是 很 成 熟 ， 修 改 频率 比 Android SDK 高 得 多 。 你 下 载 的 版 本 可 能 不 同 于 本 
书 使 用 的 版 本 ， 可 能 还 会 有 一 些 独 特 之 处 。 


有 鉴于 此 ， 建议 令 其 自动 检测 更 新 ,， 以便 立 即 下 载 并 安装 新 的 更 新 。 还 可 以 随时 手动 检查 更 
新 ， 为 此 可 选择 菜单 Help> Check for Update。 














1.5.2 添加 SDK 包 


Android Studio 安 装 程序 包含 Android SDK 和 基本 开发 工具 。 然 而 ， 随 着 学 习 的 不 断 深 入 ， 你 
可 能 会 发 现 还 需要 其 他 工具 。 要 获取 这 些 工 具 ， 可 运行 Android SDK Manager。 











OD http://d.android.com/tools/device.html 
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在 Android Studio 中 ， 选 择 菜 单 Tools> Android> SDK Manager。 管 理 器 将 显示 一 个 可 用 组 件 | 













































































SI 人 = 二 上 三 
列表 ， 其 中 包括 文档 、 平 台 、 插 件 库 和 USB 驰 动 程序 ， 如 图 1-9 所 示 。 
一 一 OO 
Android SDK Manager ex) 
Packages Tools 
SDK Path: C:\Users\Ed\AppData\Loca\Android\sdk 
Packages 
踢 ! Name API Rev. Status 
4 加 Android51 (API22) 
贺 仿 Documentation for Android SDK 22 1 区 Installed s 
贺 看 SDK Platform 22 1 区 Installed | 
回 生 Samples for SDK 2 5 区 Installed 
| 辐 表 Android TV ARM EABI v7a System Image 22 1 区 Installed 
I 同村 Android TV Intel x86 Atom System Image 2 1 区 Installed 
| | 回转 ARM EABI v7a System Image 22 1 区 Installed 
| 回 吧 Intel x86 Atom_64 System Image 22 1 区 Installed 
| 回国 Intel x86 Atom System Image 22 1 区 Installed 
| 贺 中 GoogleAp 22 1 区 Installed 
| 加 车 Google APls ARM EABI v7a System Image 2 1 区 Installed 
| 贺 呆 GoogleApls Intel x86 Atom_64 System Image 22 1 区 Installed 
| 回转 GoogleApls Intel x86 Atom System Image 22 1 区 Installed | 
| TT sourcec far Andrnid SNK 22 1 BB Inetalled i 
41| 器 ] » | 
Show [VUpdates/New [YjiInstalled Select New or Updates Install packages.. 
1 Obsolete Deselect All Delete packages 
| 
| | [WW] Ee] 
| Done loading packages. 
\======—=—== 


= = >| 








建议 安装 如 下 组 件 的 最 新 版 本 。 

口 Android SDK Tools: 软件 开发 包 。 

口 Android SDK Platform-tools: 低级 工具 ， 如 adb ( Android Debug Bridge )。 
口 Android SDK Build-tools: 编译 工具 。 

口 Android $.1 (API 22 ) ( 或 更 高 版 本 ): 安装 最 高 版 本 的 所 有 组 件 。 


安装 类 别 Extras 下 的 如 下 组 件 。 


口 Android Support Repository: gradle 需 要 它 。 

口 Android Support Library: 用 于 与 较 旧 的 Android 版 本 兼容 。 

口 Google Play services: 增值 库 ， 包 含 很 多 不 错 的 功能 。 

口 Google Repository: gradle 需 要 它 。 

口 Google USB Driver ( 仅 Windows ): 让 你 能 够 在 实际 设备 上 运行 和 调试 程序 。 
口 Intel x86 Emulator Accelerator: 提高 模拟 器 速度 的 插件 包 。 


选择 要 安装 的 所 有 组 件 后 ， 单 击 Install 按 钮 。 安 装 可 能 需要 很 长 时 间 才 能 完成 。 在 系统 询问 
是 否 接受 许可 协议 时 ， 务 必 接 受 所 有 的 许可 协议 (有 时 有 多 个 许可 协议 )。 出 现 有 关 重 启 SDK 
Manager 的 消息 时 ， 让 系统 重启 就 是 了 。 如 果 出 现 HTTPS SSL 错 误 ， 请 在 Android SDK Manager 
中 选择 菜单 Tools> Options， 青 选择 复 选 框 Force https:// sources to be fetched using http://。 
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1.6 ”快速 阅读 指南 





拜 Android Studio 所 赐 ， 创 建 一 个 Android 程 序 骨架 只 需 几 秒 钟 。 第 3 章 将 开始 充实 这 个 骨架 ， 
让 它 变 成 一 个 货真价实 的 应 用 一 一 一 个 井 字 游戏 。 本 书 的 很 多 章 都 将 使 用 这 个 示例 来 演示 
Android API, 

在 着 手 编写 这 个 游戏 之 前 ， 请 先 花 几 分 钟 时 间 阅 
后 ， 本 书 余 下 的 内 容 理 解 起 来 将 会 容 


各 会 容易 得 多 。 



































-和 


读 第 2 章 。 掌 握 活动 和 生命 周期 等 基本 概念 





开发 Android 程 序 时 ， 并 非 一 定 要 使 用 Android Studio， 不 过 还 是 强烈 建议 使 用 它 。 如 果 你 以 
前 从 未 使 用 过 IntelliJ]， 可 能 应 该 花 点 时 间 阅 读 JetBrains 网 站 ”的 Intelli] IDEA 快 速 入 门 指 南 。 需 要 
特别 注意 的 是 快捷 键 ， 因 为 只 要 牢记 几 个 快 损 

















E 键 ， 就 可 以 节省 大 量 时 间 。 





GD http:/www.jetbrains.com/idea/documentation 
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重要 概念 











对 Android 是 什么 有 大 致 了 解 后 , 来 看 看 其 工作 原理 。 对 于 Android 的 有 些 组 成 部 分 ， 如 Linux 
内 核 和 SQL 数据 库 ， 你 可 能 很 熟悉 ， 而 对 于 其 他 组 成 部 分 ， 如 Android 的 应 用 生命 周期 概念 ， 你 
可 能 是 完全 陌生 的 。 

要 编写 行为 良好 的 Android 应 用 ， 必 须 深 入 了 人 解 这 些 重 要 概念 。 因 此 ， 如 果 你 只 想 阅读 本 书 
的 某 一 章 ， 那 就 阅读 本 章 吧 。 








Dy 


2.1 总 】 
先 来 看 看 总 体系 统 架构 
体 情况 ， 请 仔细 研究 。 


应 用 和 服务 
的 应 用 


日 


Android 开 源 软件 栈 的 重要 分 层 和 组 件 。 图 2-1 说 明了 Android 的 总 














应 用 框架 
| “活动 管理 器 | | 窗口 管 理 器 








视图 系统 “| 通知 管理 器 | 


ey 
详 
族 
:村 
器 














位 置 管理 器 。 | | 传 感 管理 器 | 





[管理 着 “| | 一 电话 管理 器 | | 资源 





库 Android 运行 时 

[和 管理 器 “| | 媒体 椎 架 | [—saue— | 核心 库 

| openGL|ES Freerype | chomum | DaliwaeRT 
虚拟 机 




















Linux 内 核 
| 显示 驱动 程序 ”| | 蓝牙 驱动 程序 | 相机 驱动 程序 ”| ”内存 驱动 程序 | | Bee | 














| “键盘 驱动 程序 “| | USB 驱动 程序 | WiFi 驱 动 程序 下 音频 驱动 程序 “| | 电源 管理 “| 





图 2-1 _ Android 系统 架构 


每 层 都 使 用 它 下 面 各 层 提供 的 服务 。 下 面 从 最 底层 开始 ,来 着 重 介绍 Android 的 各 层 。 
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2.1.1 Linux 内 核 


Android 以 经 过 实践 检验 的 可 靠 Linux 内 核 为 基础 。Linux 是 Linus Torvalds 于 1991 年 开发 的 , 目 
前 被 广泛 用 于 从 腕 表 到 超级 计算 机 的 各 种 设备 中 。Linux 为 Android 提 供 了 硬件 抽象 层 , 让 Android 


能 够 移植 到 各 种 平台 之 上 。 


在 内 部 ，Android 使 用 Linux 来 提供 内 存 管 悍 





 、 进 程 管理 、 联 网 和 其 他 操作 系统 服务 。Android 








用 户 根 本 看 不 到 Linux， 而 你 编写 的 程序 通常 也 不 会 直接 使 用 Linux 调 用 。 然 而 ， 作 为 开发 人 员 ， 
你 必须 知道 Linux 内 核 的 存在 。 

在 开发 期 间 所 使 用 的 某 些 工具 会 与 Linux 进 行 交 互 。 例 如 ， 命 令 adb shell" 用 于 打开 一 个 
Linux shell, 让 你 能 够 在 其 中 输入 要 在 设备 上 运行 的 其 他 命令 。 你 可 以 通过 它 审视 Linux 文 件 系 统 、 











2.1.2 原生 库 


























查看 活动 进程 等 ,但 要 受到 安全 限制 的 约束 。 








内 核 的 上 一 层 包 含 Android 原 生 库 。 这 些 共 享 库 都 是 使 用 C 或 C++ 编 写 的 , 针对 Android 设 备 使 








用 的 硬件 架构 进行 编译 ， 并 





厂商 预 装 。 



































下 面 是 一 些 最 重要 的 原 


口 Surface Manager: 绘 


生 库 。 


























图 命令 并 不 直接 在 屏幕 上 绘画 ， 而 是 被 保存 到 列表 中 。 这 些 命令 列 表 


与 来 自 其 他 窗口 的 命令 列表 合并 ,一 起 生成 用 户 看 到 的 综合 效果 。 这 让 系统 能 够 创建 各 
种 有 趣 的 效果 ， 如 透明 窗口 和 令 人 着 迷 的 过 渡 。 





口 多 媒体 编码 解码 器 : 








浏览 器 使 用 的 引擎 ， 


可 阅读 在 线 资料 ”。 





件 转换 为 3D 绘 图 列表 并 进行 泻 染 ， 








口 2D 和 3D 图 形 : 在 Android 中 ,可 在 用 户 界面 中 同时 使 用 二 维和 三 维 元 素 。 所 有 元 素 都 由 硬 


























以 最 大 限度 地 提高 显示 速度 。 


Android 可 播放 各 种 格式 的 视频 和 音频 ， 包 括 AAC、AVC (H.264 )、 


H.263 、MP3 和 MPEG-4。 
口 SQL 数据 库 : Android 包 括 一 个 轻 量 级 的 SQLite 数 据 库 引擎 ” 
用 的 数据 库 。 可 以 在 应 用 中 使 用 它 来 实现 持久 化 存储 。 

口 浏览 器 引擎 : 为 快速 显示 HTML 内 容 ，Android 使 用 了 Chromium 库 ?。 这 是 Google Chrome 











Firefox 和 Apple iPhone 使 





与 Apple Safari 浏 览 器 和 Apple iPhone 使 用 的 引擎 很 像 。 


这 些 库 本 身 并 非 应 用 , 仅 供 更 高 层 的 程序 调用 。 要 编写 和 部 署 原 生 库 ， 可 使 用 原生 开发 工具 
包 (NDK，Native Development Toolkit )。 原 生 开 发 不 在 本 书 的 讨论 范围 内 ， 如 果 你 对 此 感 兴 趣 ， 


GD http://d.android.com/tools/help/adb.html 


© http:/www.sqlite.org 
® http:/www.chromium.org 


@ http://d.android.com/tools/sdk/ndk 
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2.1.3 Android 运行 时 


在 内 核 之 上 , 还 有 Android 运 行 时 , 包括 运行 环境 和 核心 Java 库 。 运行 环境 使 用 Dalvik 或 ART， 
具体 使 用 哪个 取决 于 Android 版 本 。 

Dalvik 是 Google 的 Dan Bornstein 设 计 并 编写 的 一 款 虚 拟 机 ( VM )。 我 们 编写 的 代码 会 被 编译 
为 独立 于 机 需 的 指令 一 一 字 节 码 ， 然 后 由 移动 设备 上 的 Dalvik VM 执行 。 

ART ( Android Runtime ) 是 一 款 超前 的 编译 器 ，Android 5.0( Lollipop ) 用 它 取 代 了 Dalvik。 
ART 在 将 应 用 安装 到 Android 设 备 时 会 将 其 编译 成 机 器 码 。 相 比 于 Dalv 站 ，ART 可 以 提高 程序 的 运 
行 速 度 ， 但 代价 是 安装 时 间 更 长 。 

Dalvik 和 ART 都 是 Google 推 出 的 准 兼容 性 Java 实 现 ， 都 针对 移动 设备 进行 了 优化 。 在 Android 
开发 中 ， 所 有 代码 都 使 用 Java 编 写 ， 并 由 Dalvik 或 ART 运 行 。 

请 注意 , Android 自 带 的 核心 Java 库 不 同 于 Java Standard Edition( Java SE ) 库 和 Java Mobile 
Edition ( Java ME ) 库 ， 但 它们 有 很 多 相同 的 地 方 。 附 录 对 Android Java 库 和 标准 Java 库 做 了 
比较 [e) 




















































































































2.1.4 应 用 框架 


在 原生 库 和 运行 时 之 上 , 是 应 用 框架 层 。 它 提供 了 用 于 创建 应 用 的 高 级 构件 。 这 个 框架 是 随 
Android 预 安装 的 ， 你 可 以 根据 需要 对 其 进行 扩展 ， 在 其 中 添加 自己 的 组 件 。 





拥抱 并 扩展 

Android 的 一 个 独特 而 强大 之 处 是 ， 所 有 应 用 都 处 于 一 个 公平 竞争 的 环境 中 。 也 就 是 说 ， 
系统 应 用 与 第 三 方 应 用 一 样 ， 都 使 用 相同 的 公有 API。 如 果 你 愿意 ， 甚 至 可 以 让 Android 用 你 
的 应 用 替换 标准 应 用 。 














下 面 是 应 用 框架 最 重要 的 组 成 部 分 。 

口 活动 管理 器 : 它 控 制 着 应 用 的 生命 周期 (参见 2.3 节 ),， 并 维护 一 个 用 于 用 户 导航 功能 的 通 
用 后 退 栈 。 
口 2 
资源 管理 虽 
口 
口 通知 管理 虽 











NN 








这 些 对 象 封装 了 要 在 应 用 之 间 共 享 的 数据 ， 如 通讯 录 。 详 情 请 参阅 2.2.6 节 。 
:资源 指 的 是 程序 中 除 代码 之 外 的 其 他 所 有 东西 ， 详 情 请 参阅 2.2.7 节 。 
Android 设备 始终 知道 其 身 处 何方 ， 详 情 请 参阅 第 12 章 。 

: 以 不 唐 突 的 方式 将 短信 、 约 会 、 接 近 提 示 、 外 族 入 侵 等 事件 告知 用 户 。 

















器 器 器 
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2.1.5 ”应 用 和 服务 


在 前 面 的 Android 架 构图 中 , 最 顶层 是 应 用 和 服务 层 。 它 相当 于 Android 冰 山 露 出 水 面 的 部 分 。 
最 终 用 户 只 能 看 到 应 用 ,并 乐于 对 水 面 下 的 情况 一 无 所 知 。 但 作为 开发 人 员 ， 你 必须 对 此 有 更 深 
入 的 了 解 。 

应 用 是 可 以 占据 整个 屏幕 并 与 用 户 进 行 交 互 的 程序 , 而 服务 则 隐匿 在 用 户 的 视线 之 外 ,， 默 
地 扩展 应 用 框架 。 本 书 主要 介绍 应 用 的 开发 ， 因 为 我 们 所 编写 的 大 多 都 是 应 用 。 

Android 手 机 和 平板 电脑 在 出 三 时 自 带 了 很 多 标准 系统 应 用 ， 其 中 包括 : 
口 电话 拨号 程序 
口 电子 邮件 
口 相机 
口 Web 浏 览 磊 
口 Google Play 商店 

使 用 Google Play 商店 ， 用 户 可 将 新 程序 下 载 到 自己 的 手机 上 运行 。 这 正 是 你 的 用 武之 地 。 阅 
读 完 本 书 之 后 ， 你 将 能 够 编写 出 非常 棒 的 Android 应 用 。 

Android 应 用 框架 提供 了 大 量 可 用 于 创建 应 用 的 构件 ， 下 面 就 来 对 其 进行 介绍 。 
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2.2 构件 


在 Android SDK 中 定义 了 一 些 每 个 开发 人 员 都 必须 熟悉 的 对 象 , 其 中 最 重要 的 是 活动 、 片 段 、 
视图 、 意图、 服务 和 内 容 提 供 絮 。 本 书后 面 将 通过 示例 讨论 这 些 对 象 , 下 面 简要 地 介绍 一 下 它们 。 























2.2.1 活动 


活动 是 一 个 用 户 界面 屏幕 。 应 用 可 以 定义 一 个 或 多 个 活动 ， 用 于 处 理 程序 的 不 同 阶段 。 正 如 
即将 在 2.3 节 进行 讨论 的 ， 每 个 活动 都 负责 保存 自己 的 状态 ， 以 便 能 够 在 应 用 生命 周期 的 后 续 阶 
段 恢 复 这 些 状 态 。 有 关 这 样 的 示例 请 参阅 3.2.1 节 。 活 动 扩展 了 Context 类 ， 因 此 可 使 用 它们 来 获 
取 应 用 的 全 局 信息 。 



































2.2.2 片段 
片段 是 活动 的 一 个 组 成 部 分 ， 通常 显示 在 屏幕 上 ， 但 并 非 必须 如 此 。 片 段 是 Android 3.0 
(Honeycomb ) 引入 的 ， 如 需 针 对 较 旧 的 Android 版 本 时 ， 可 使 用 兼容 库 。 


在 电子 邮件 程序 中 ， 一 部 分 用 于 显示 收 到 的 所 有 邮件 ， 还 有 一 部 分 用 于 显示 特定 邮件 的 内 容 ， 
这 两 部 分 都 可 实现 为 片段 。 通 过 使 用 片段 , 能 够 让 应 用 更 轻松 地 适应 不 同 尺寸 的 屏幕 , 如 图 2-2 所 示 。 
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平板 电脑 人 手机 


一 选择 一 个 列表 项 人 选择 一 个 列表 
更 新 片段 B | 归 宙 外 反 





































































































活动 A 包含 片段 A 和 B :| “活动 A 包含 。 ”活动 B 包 含 
舌 动 A 包 含 片段 A 和 ， 卢 女 B 





2.2.3 视图 


视图 是 最 小 的 用 户 界面 单元 , 可 以 直接 包含 在 活动 中 ,也 可 以 包含 在 活动 的 片段 中 。 视 图 可 
使 用 Java 代 码 来 创建 , 但 更 佳 的 方式 是 使 用 XML 布 局 来 定义 。 每 个 视图 都 有 一 系列 的 属性 ,它们 
决定 了 视图 的 功能 、 行 为 和 外 观 。 























2.2.4 意图 


意图 是 一 种 行为 (如 选择 照片 、 给 家 里 打 电 话 、 打 开 舱 门 ) 描述 机 制 。 在 Android 中 ， 几 乎 
一 切 都 是 通过 意图 来 实现 的 ,这 给 我 们 提供 了 大 量 蔡 换 或 重用 组 件 的 机 会 。 有 关 意 图 的 示例 , 请 
参阅 10.1 节 。 

例如 ， 有 一 个 用 于 发 送 电 子 邮件 的 意图 ， 如 果 你 的 应 用 需要 发 送 邮 件 ， 则 可 调用 这 个 意图 。 
另外 ,在 编写 电子 邮件 应 用 时 ， 可 以 注册 一 个 活动 ， 让 它 来 处 理 上 述 意图 ， 从 而 蔡 换 标准 邮件 程 
序 。 这 样 ， 当 用 户 再 次 发 送 邮 件 时 ， 就 可 以 使 用 你 编写 的 程序 ， 而 不 是 标准 邮件 程序 。 























2.2.5 服务 


服务 是 在 后 台 运行 的 任务 ， 无 需 用 户 与 之 直接 进行 交互 ， 类 似 于 Linux 守 护 程序 。 就 拿 音乐 
播放 器 来 说 吧 。 音乐 可 能 是 由 活动 播放 的 , 但 你 可 能 希望 它 不 断 播放 ， 即便 用 户 已 经 切换 到 了 其 
他 程序 。 因 此 , 实际 执行 播放 的 代码 应 该 放 在 服务 中 。 然后, 可 能 会 将 另 一 个 活动 绑 定 到 该 服务 ， 
让 它 负 责 切换 音 轨 或 停止 播放 。 
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Android 自 带 了 很 多 内 置 服务 , 还 有 能 够 方便 访问 这 些 服 务 的 API。Google 还 提供 了 支持 额外 
功能 的 可 选 服务 ， 详 情 请 参阅 第 12 章 。 





2.2.6 ”内 容 提供 器 


内 容 提 供 器 是 一 组 数据 和 用 于 读 取 它们 的 自 定 义 API， 这 是 在 应 用 之 间 共 享 全 局 数据 的 最 佳 
方式 。 例 如 ，Google 提 供 了 一 个 包含 通讯 录 的 内 容 提 供 器 ， 其 中 所 有 信息 (包括 姓 名 、 地 址 、 电 
话 号 码 等 ) 都 可 供 任 何 应 用 使 用 。 有 关 这 方面 的 示例 ， 请 参阅 13.5 节 。 





























2.2.7 ”使 用 资源 


资源 是 本 地 化 的 文本 字符 串 、 位 图 或 程序 需要 的 其 他 非 代码 信息 。 在 编译 阶段 ， 所 有 资源 都 
将 被 编译 到 应 用 中 ， 这 有 助 于 国际 化 和 对 多 种 设备 的 支持 。 详 情 请 参阅 8.3.1 节 。 


你 将 在 项 目的 res 目 录 中 创建 和 存储 资源 。Android 资 源 编 辑 器 (aapt ) "根据 资源 文件 所 属 的 
文件 夹 和 格式 对 其 进行 处 理 。 例 如 ， 对 于 PNG 和 JPG 格 式 的 位 图 ， 应 放 在 目录 res/drawable 下 ， 而 
描述 布局 的 XML 文件 应 放 在 目录 reslayout 下 。 可 以 添加 相应 的 后 级 ， 以 指定 语言 、 屏 幕 朝向 、 像 
素 密度 等 。 详 情 请 参阅 8.3 节 。 

资源 编译 器 对 资源 进行 压缩 和 打包 ， 再 生成 一 个 名 为 R 的 类 ， 其 中 包含 可 用 于 在 程序 中 引用 
这 些 资 源 的 标识 符 。 这 与 使 用 字符 串 键 引用 的 标准 Java 资 源 稍 有 不 同 。 通 过 使 用 标识 符 来 引用 资 
源 ， 能 够 让 Android 确 保 所 有 的 引用 都 是 有 效 的 ， 同 时 还 避免 了 存储 所 有 的 资源 键 ， 从 而 节省 了 
空间 。 第 3 章 将 通过 一 个 示例 演示 如 何在 代码 中 访问 资源 。 


下 面 来 更 详细 地 介绍 Android 应 用 的 生命 周期 ， 它 与 桌面 应 用 程序 的 生命 周期 稍 有 不 同 。 





































































































2.3 前 台 只 能 有 一 个 应 用 

在 标准 Linux 或 Windows 人 台式 机 中 ， 可 以 有 很 多 应 用 程序 同时 运行 ， 它 们 可 以 同时 出 现在 不 
同 的 窗口 中 。 其 中 一 个 应 用 程序 拥有 键盘 焦点 ， 除 此 之 外 ,所 有 的 应 用 程序 都 一 样 。 用 户 可 以 轻 
松 地 在 应 用 程序 之 间 进 行 切换 并 移动 窗口 〈 以 便 能 够 看 到 当前 执行 的 操作 )， 以 及 将 不 需要 的 程 
序 关 闭 。 

Android 的 工作 原理 则 不 同 。 

在 Android 中 只 有 一 个 前 台 应 用 ， 它 通常 占据 除 状 态 栏 以 外 的 整个 屏幕 。 用 户 开 启 手机 或 平 
板 电脑 时 ， 看 到 的 第 一 个 应 用 为 主屏 幕 ， 如 图 2-3 所 示 。 





















































GD http://d.android.com/tools/building 
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图 2-3 


用 户 运 行 应 用 时 ，Android 会 启动 该 应 用 并 让 它 进 入 前 台 。 在 运行 该 应 用 时 ， 用 户 可 能 还 会 
不 断 调用 其 他 应 用 或 当前 应 用 中 的 其 他 屏幕 。 系 统 的 活动 管理 需 会 将 所 有 这 些 程序 和 屏幕 都 记录 
到 应 用 栈 中 。 每 当 用 户 按 “返回 ”按钮 时 ， 都 将 返回 到 栈 中 的 前 一 个 屏幕 。 从 用 户 的 角度 来 看 ， 
这 很 像 Web 浏 览 器 的 历史 记录 ， 按 “后 退 ” 按 钮 将 返回 到 前 一 个 页 面 。 





2.3.1 进程 不 等 于 应 用 

在 内 部 ， 每 个 用 户 界 面 屏 幕 都 由 一 个 活动 表示 ( 参见 2.2.1 节 )。 每 个 活动 都 有 其 生命 周期 。 
应 用 由 一 个 或 多 个 活动 以 及 包含 这 些 活动 的 Linux 进 程 组 成 。 这 听 起 来 相当 简单 ， 不 是 吗 ? 但 别 
高 兴 得 太 早 ， 难 懂 的 地 方 就 在 后 面 。 

在 Android 中 ， 应 用 在 其 进程 终止 后 也 能 存活 。 换 名 话说 ， 活 动 的 生命 周期 并 不 受制 于 进程 
的 生命 周期 。 进 程 并 不 是 一 次 性 的 活动 容器 。 

















2.3.2 ”活动 的 生命 周期 


在 生命 周期 内 ，Android 程 序 的 活动 可 处 于 多 种 状态 ， 如 图 2-4 所 示 。 开 发 人 员 并 不 能 控制 
程序 所 处 的 状态 ,这 完全 由 系统 管理 。 然 而 , 在 状态 发 生变 化 前 ,系统 会 调用 方法 onXX( ) 来 通 
知 你 。 
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(1) onCreate() 

(2) onStart() 

(3) onRestorelnstanceState()* 
( 


4) onResume() 


3) onResume() ) onSavelnstanceState()* 
2) onStart() 2) onPause() 
cnRes onResume() 


(1) onRestart() 










~、 


(1) onSavelInstanceState()* 
(2) onStop() 

onestoyl 终 目 进程 
终止 进程 


* 表示 方法 并 非 必须 重 写 











图 2-4 


在 创建 的 Activity 子 类 时 ， 需 要 重 写 如 下 方法 ，Android 会 在 合适 的 时 候 调 用 它们 。 


口 onCreate (Bundle): 活动 首次 启动 时 被 调用 。 可 以 使 用 它 来 执行 一 次 性 初始 化 工作 ， 如 
创建 用 户 界 面 。onCreate() 接 受 一 个 参数 ， 这 个 参数 要 么 为 hull ， 要 么 为 方法 
onSaveInstanceState() 保 存 的 状态 信息 。 

口 onStart(): 表明 活动 即将 显示 给 用 户 。 

口 onResume(): 活动 能 够 开始 与 用 户 交 互 时 被 调用 。 这 是 启动 动画 和 音乐 的 理想 场所 。 

口 onPause(): 在 活动 即将 进入 后 台 (通常 是 由 于 启动 了 另 一 个 活动 ) 时 被 调用 。 应 该 在 这 

个 方法 中 保存 程序 的 持久 化 状态 ， 如 正在 编辑 的 数据 库 记 录 。 

口 onStop () te ee ee i 如 果 内 存 紧 张 ， 

onStop() 会 被 调用 (系统 可 能 会 直接 终止 进程 )。 

D onRestart () : 就 表明 原本 处 于 停止 状态 的 活动 重新 显示 到 了 屏 

幕 上 。 

口 onDestroy() : 在 活动 销毁 前 被 调用 。 如 果 内 存 紧 张 , onDestroy () 可 能 不 会 被 调用 ( 系 

并 

DQ onSaveInstanceState(Bundle): Android 调 用 这 个 方法 让 活动 保存 其 特有 的 状态 ， 如 
光标 在 文本 框 中 的 位 置 。 通 常 不 需要 重 写 这 个 方法 ， 因 为 默认 实现 会 自动 保存 所 有 用 户 
界面 控件 的 状态 。 
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口 onRestoreInstanceState(Bundle): 根据 onSaveInstanceState() 方 法 保存 的 状态 重 
新 初始 化 活动 时 被 调用 ， 其 默认 实现 会 恢复 用 户 界面 的 状态 。 
不 在 前 台 运 行 的 活动 可 能 会 被 停止 。 男 外 ， 包 含 此 类 活动 的 Linux 进 程 也 可 能 随时 被 终止 ， 
以 便 为 新 活动 腾 出 空间 。 这 种 情况 屡见不鲜 。 因 此 在 设计 应 用 时 ， 一 开始 就 必须 考虑 到 这 一 点 
这 很 重要 。 在 某 些 情况 下 ，onPause() 可 能 是 最 后 一 个 被 调用 的 活动 方法 ， 因 此 对 于 要 保 图 到 下 
次 使 用 的 任何 数据 ， 都 必须 在 这 里 进行 保存 。 


从 Android 3.0 ( Honeycomb ) 起 ，Google 在 应 用 生命 周期 的 故事 中 引入 了 另 一 个 情节 一 一 
片段 。 











2.3.3 ”使 用 片段 简化 工作 


片段 是 应 用 的 组 成 部 分 ， 它 们 包含 在 活动 中 (参见 2.2.2 节 )， 其 生命 周期 与 活动 很 像 。 事 实 
上 ， 片 段 的 很 多 生命 周期 方法 都 是 由 活动 的 方法 调用 的 〈 例 如 ，Fragment .onResume() 间 接地 
由 Activity .onResume() 调 用 )。 详 情 请 参阅 图 2-5。 


(1) onlnflate() (2) onDetach() 


(2) onAttach() | (1) onDestroy() 


(3) onCreate() | 


(4) onDestroyView() 





(1) onCreateView() 
(2) onActivityCreated() 


(3) onViewStateRestored() 


> ) onSavelnstanceState()* 
14) onStarto* 7 onStopO* 


(4) onStart() 3 
) onPause 
(5) onResume()* ~ 2 


图 2-5 

不 存在 包含 它们 的 活动 时 ， 片 段 依然 可 以 存在 。 例 如 ， 如 果 你 在 应 用 运行 时 旋转 屏幕 ， 活 动 
通常 会 被 销毁 并 重新 创建 ， 以 适应 新 的 屏幕 朝 向 ,但 片段 通常 会 被 保留 。 这 样 能 够 在 朝向 切换 期 
间 保 留 网 络 连接 等 重量 级 对 象 。 


“表示 与 活动 相关 联 的 方法 
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2.4 安全 保障 


前 面 说 过 ， 每 个 应 用 都 运行 在 自己 的 Linux 进 程 中 。 硬 件 禁 止 一 个 进程 去 访问 另 一 个 进程 的 
内 存 。 另 外 ， 每 个 应 用 都 被 分 配 了 一 个 独特 的 用 户 ID 。 只 要 设备 没有 被 root ( 以 更 高 的 权限 运行 
应 用 )， 一 个 应 用 创建 的 文件 就 不 能 被 其 他 应 用 读 写 。 

另外 ， 限 制 了 对 一 些 关 键 操 作 的 访问 。 要 使 用 这 些 操作 ， 必 须 在 文件 AndroidManifestxml 中 
请 求 相 应 的 权限 。 在 应 用 安装 时 ,， 包 管理 器 将 根据 证 书 授予 或 不 授予 请 求 的 权限 ， 并 在 必要 时 询 
问 用 户 。 下 面 是 一 些 最 常见 的 权限 。 


口 INTERNET: 访问 Internet。 

口 READ_CONTACTS: 读 取 但 不 写 人 用 户 的 联系 人 数据 。 

D WRITE_CONTACTS: 写 入 但 不 读 取 用 户 的 联系 人 数据 。 

口 RECEIVE_SMS: 监视 收 到 的 短信 。 

口 ACCESS_COARSE LOCATION: 使 用 粗糙 的 位 置 提供 咒 ， 如 基站 或 Wi-Fi。 
口 ACCESS_FINE_LOCATION: 使 用 更 精确 的 位 置 提 供 器 ， 如 GPS。 


例如 ， 要 监视 收 到 的 短信 ， 需 要 在 清单 文件 中 包含 如 下 内 容 : 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.google.android.app.myapp" > 
<uses-permission android:name="android.permission.RECEIVE SMS" /> 
</manifest> 


Android 其 至 可 以 限制 访问 系统 的 特定 部 分 。 通 过 在 AndroidManifest.xml 中 使 用 XML 标 签 ， 
可 指定 谁 可 启动 活动 、 启 动 或 绑 定 服务 、 向 接收 器 广播 意图 以 及 访问 内 容 提供 器 中 的 数据 。 这 种 
高 级 控制 不 在 本 书 的 讨论 范围 内 ， 要 更 深入 地 了 解 ， 可 参阅 有 关 Android 安 全 模型 的 在 线 帮助 ”。 

































































2.5 快速 阅读 指南 


本 书 余 下 的 篇 幅 将 使 用 本 章 介绍 的 所 有 概念 。 第 3 章 将 使 用 活动 和 生命 周期 方法 来 定义 一 个 
示例 应 用 ， 第 6 章 将 探索 多 媒体 编码 解码 器 ， 而 第 13 章 将 介绍 内 容 提 供 器 。 














GD http://d.android.com/training/articles/security-tips.html 
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开发 一 个 游戏 
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开局 走 法 








在 第 1 章 ， 我 们 使 用 Android Studio 编 写 了 一 个 简单 的 “Hello, Android” 程 序 。 这 在 几 分钟 内 
就 完成 了 ,但 功能 有 限 。 在 第 二 部 分 ,我们 将 创建 一 个 有 趣 得 多 的 应 用 一 一 终极 版 井 字 游戏 
(Ultimate Tic-Tac-Toe )。 

通过 不 断 给 这 个 程序 添加 功能 ， 你 将 学 习 Android 编 程 的 很 多 方面 。 这 些 知识 将 有 助 于 你 编 
写 自己 的 程序 一 一 游戏 、 商 业 应 用 以 及 你 能 想象 得 到 的 任何 程序 。 我 们 将 从 用 户 界面 着 手 。 

在 本 书 中 ， 每 个 示例 都 被 完整 地 呈现 了 出 来 ， 以 便 能 够 让 你 在 阅读 的 同时 在 Android Studio 
中 跟着 做 。 你 可 以 从 本 书 配套 网 站 "下 载 这 些 示 例 ， 这 样 可 以 节省 大 量 的 代码 输入 时 间 。 如 果 你 
阅读 的 是 电子 版 ， 那 么 可 以 单 击 代码 清单 前 面 的 文件 名 ， 直 接 下 载 该 文件 。 



































3.1 创建 井 字 游戏 示例 

人 人 都 会 玩 井 字 游 戏 : 一 个 3x3 的 棋盘 ， 最 初 是 空 的 ， 两 个 玩家 轮流 在 空格 中 填写 X 或 0， 先 
将 自己 的 3 个 棋子 连 成 线 者 获胜 。 如 果 棋 盘 填 满 后 还 没 人 将 3 个 棋子 连 成 线 ， 就 视 为 平局 。 

终极 版 并 字 游 戏 ? 与 此 类 似 ， 只 不 过 每 格 都 内 骨 了 一 个 井 字 ， 玩 家 不 是 通过 下 子 来 占据 各 个 
格子 ， 而 是 需要 玩 赢 格子 内 的 井 字 游 戏 才 能 占据 它 ， 如 图 3-1 所 示 。 

终极 版 井 字 游 戏 有 很 多 变 体 ， 这 里 采用 这 样 的 变 体 : 在 大 格 包含 的 井 字 游戏 为 平局 时 ， 算 双 
方 都 赢 ， 其 规则 与 流行 的 Android 和 ioOS 游 戏 “ 并 字 策 略 ( Tic Tactics “类 似 。( 需要 指出 的 是 ， 
我 与 “ 井 字 策 略 ”游戏 的 开发 商 一 点 儿 关 系 都 没有 , 但 要 不 是 因为 我 花 了 太 多 时 间 在 玩 这 个 游戏 
上 ， 也 许 本 书 在 一 年 前 就 付 梓 了 。) 

为 了 新 建 一 个 程序 ， 选 择 菜 单 File>New Project 并 输入 如 下 信息 。 

口 应 用 名 : Tic Tac Toe 


















































QD http://pragprog.com/book/eband4 
© http://mathwithbaddrawings.com/2013/06/16/ultimate-tic-tac-toe 
©®@ http://www.hiddenvariable.com/tictactics/ 
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口 公司 域名 : example.org 

口 尺寸 : Phone and Tablet 

口 最 低 SDK: API 16: Android 4.1 (Jelly Bean) 
口 添加 活动 : Blank Activity 

口 活动 名 : MainActivity 

口 布局 名 : activity_ main 

口 标题 : UT3 
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DODIaoo 可 xD 
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图 3-1 ” 井 字 游戏 遇 上 《 资 梦 空间 》 
可 将 目录 res/menu 删 除 ， 因 为 这 个 项 目 不 需 要 它 。 
在 编写 这 个 程序 的 实际 代码 前 ， 需 要 设计 起 始 屏幕 。 为 此 ， 我 们 将 编辑 一 个 XML 布局 文件 。 




















3.2 ”使 用 XML 进行 设计 

在 Android 中 ， 定 义 用 户 界 面 的 方式 有 两 种 : 使 用 代码 和 使 用 XML。 通常 推荐 使 用 XML， 
为 相 比 于 Java 代 码 ， 使 用 XML 来 创建 界面 以 及 设置 界面 样式 会 更 容易 。 

Android Studio 包 含 一 个 可 视 化 布局 编辑 器 ， 让 你 能 够 使 用 鼠标 将 按钮 和 列表 等 控件 拖 放 到 
画布 上 ， 然 后 调整 它们 的 位 置 ， 最 终 创 建 出 漂亮 的 用 户 界 面 。 你 应 该 好 好 研究 一 下 该 编辑 器 的 用 
法 并 多 多 加 以 使 用 。 不 过 本 书 只 负责 介绍 如 何 处 理 它 创 建 的 XML 文本 ， 以 便 让 你 更 深入 地 了 解 
相关 工作 原理 。 









































3.2.1 创建 主屏 幕 


我 们 希望 这 个 程序 启动 时 显示 如 下 选项 : 接着 玩 游戏 、 开 始 新 游戏 以 及 显示 有 关 该 程序 的 信 
息 。 图 3-2 显 示 了 我 们 要 设计 的 屏幕 。 
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Ultimate Tic Tac Toe 


Continue 





New Game 





About 














图 3-2 





为 创建 这 个 屏幕 , 需要 编辑 文件 activity main.xml。 为 此 , 进入 Android Studio 的 项 目 ( Project ) 
窗口 , 并 双击 文件 夹 res/layout 中 的 文件 名 activity_main.xml。 请 注意 , 项 目 窗口 有 3 种 模式 : Project、 
Packages 和 Android。 要 切换 模式 ， 可 使 用 窗口 名 旁边 的 下 拉 列 表 。 


如 果 没 有 看 到 XML ， 请 单 击 编辑 器 窗口 底部 的 Text 标 签 。 将 文本 修改 成 如 下 内 容 。 























ticTacToev1/src/main/res/layout/activity_main.xml 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android:clipChildren="false" 
tools:context=".TicTacToeActivity"> 


<fragment 

android:id="@+id/main fragment" 
class="org.example.tictactoe.MainFragment" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:layout gravity="center" 
tools:layout="@layout/fragment main"/> 

</FrameLayout> 


这 里 定义 了 一 个 FrameLayout 视 图 , 它 履 盖 了 整个 屏幕 ， 其 中 有 一 个 浮动 的 片段 (该 片段 为 
类 MainFragment 的 实例 )、 如 果 要 让 代码 正确 地 对 齐 ， 可 选择 菜单 Code>Reformat Code， 也 可 
使 用 快捷 键 (在 Windows 中 为 Ctrl+Alt+L )。 


如 果 你 是 手动 将 这 些 代码 输入 到 Android Studio 中 的 ， 将 发 现 有 些 文本 是 红色 的 ， 日 预览 窗 
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口中 显示 了 错误 消息 ( 如 果 打 开 了 该 窗口 )。 这 是 因为 其 中 有 两 个 部 分 还 没有 定义 ， 稍 后 将 添加 
它们 。 

FrameLayout 是 Android 所 支持 的 多 种 布局 视图 中 的 一 种 。 这 些 视 图 会 对 它们 所 包含 的 视图 进 
行 排列 ， 以 创建 出 所 需 的 效果 。 布 局 有 很 多 种 ,你 还 可 以 创建 自 定义 布局 。 下 面 总 结 了 最 常见 的 
布局 类 型 ， 你 在 程序 中 很 可 能 会 用 到 。 


D FrameLayout: 以 堆 春 方式 显示 一 个 或 多 个 子 视图 。 [二 

口 GridLayout: 将 子 视图 按 行 和 列 排列 。 

口 LinearLayout: 将 所 有 子 视 图 排列 成 一 行 或 一 列 。 

口 ReLativeLayout: 一 种 灵活 的 布局 ， 以 相对 于 其 他 视图 的 方式 排列 视图 。 

有 关 Android 布 局 的 完整 列表 ， 以 及 对 每 种 布局 可 设置 的 选项 的 详情 ， 请 参阅 在 线 文档 "。 
由 于 只 有 一 个 子 视 图 ,因此 使 用 的 布局 不 会 影响 该 视图 的 外 观 。 由 于 FrameLayout 最 简单 且 
效率 最 高 ， 因 此 我 们 选择 使 用 这 种 布局 。 
1. FrameLayout 标 签 的 属性 
每 个 XML 标签 都 有 控制 器 功能 的 属性 ， 下 面 更 深入 地 介绍 前 面 给 FrameLayout 标 签 设 置 的 

性 。 

口 xmLns:android="http://schemas.android.com/apk/res/android" : 定义 命名 空 

间 ?android， 以 便 能 够 在 后 面 使 用 包含 android :的 属性 名 。 

口 xmLns :tooLs="http://Sschemas ,android.com/toots": 定义 命名 空间 tools。 

口 android:1layout width="match_parent": 将 视图 设置 为 与 父 视 图 等 宽 。 由 于 是 顶级 
元 素 ， 这 意味 着 它 将 与 屏幕 等 宽 。 该 属性 可 设置 为 match_parent、wrap_content 或 绝 
对 宽度 值 。 

口 android:layout height="match parent": 将 视图 设置 为 与 父 视 图 (屏幕 ) 等 高 。 对 

于 每 个 视图 ， 都 必须 设置 宽度 和 高 度 。 

口 tooLs : context=" .TicTacToeActivity": 指出 该 布局 文件 是 供 TicTacToeActivity 类 
使 用 的 。 不 同 于 其 他 属性 ,该 属性 是 供 可 视 化 编辑 器 使 用 的 ， 而 不 是 在 运行 阶段 使 用 的 。 

2. fragment 标 签 的 属性 

下 面 是 前 面 为 fragment 标 签 设置 的 所 有 属性 的 含义 。 

口 android:id="@+id/fragment_main": 定义 新 资源 标识 符 fragment_main, 在 代码 或 其 

他 XML 属 性 中 使 用 。@+ 表 示 定 义 新 内 容 ，@ 表 示 引 用 已 在 其 他 地 方 定义 过 的 内 容 。 


口 class="org.example.tictactoe.MainFragment": 让 Android 知 道 这 个 片段 是 MainFr 





















































| 










































































QD http://d.android.com/guide/topics/ui/declaring-layout.html 
© http://en.wikipedia.org/wiki/XML namespace 
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agment 类 的 一 个 实例 。 换 名 话说 ，Android 在 根据 XML 创 建 该 片段 时 ， 将 创建 一 个 
MainFragment 实 例 。 这 个 类 将 在 3.3.2 节 定义 。 





值 包 括 top 、bottom、Left 、right 、center 和 fitLL 等 。 可 将 该 


连接 的 值 ， 如 top| right。 
口 tooLs:Layout="GLayout/fragment_main": 引用 另 一 个 XML 文件 ， 该 XML 文件 定义 
了 片段 的 内 容 。 


3.2.2 ”创建 主 片段 
主 片段 包含 3 个 按钮 ， 分 别 用 于 继续 游戏 、 开 始 新 游戏 以 及 显示 有 关 游戏 的 信息 。 我 们 将 在 
fragment main.xml 中 定义 它们 。 


要 创建 这 个 文件 , 可 单 击 文件 activity main.xml, 然后 依次 按 Ctrl+C ( 复制 ) 和 Ctrl+V (粘贴 )。 
在 系统 提示 指定 新 的 文件 名 时 , 输入 fragment main.xml( 还 有 其 他 创建 文件 的 方式 , 如 使 用 向 导 ， 








但 在 我 看 来 ， 这 种 方式 是 最 快 的 )。 


将 fragment _ main.xml 的 内 容 替 换 为 如 下 文本 。 





ticTacToev1/src/main/res/layout/fragment_main.xml 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 


xmlns:tools="http://schemas.android.com/tools" 


android: 
android: 
android: 
android: 
android: 
android: 


layout width="wrap_ content" 

layout height="wrap content" 
background="@drawable/menu_ background" 
elevation="@dimen/elevation high" 
orientation="vertical" 
padding="@dimen/menu_ padding" 


tools:context=".TicTacToeActivity"> 


<TextView 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:layout marginBottom="@dimen/menu_space" 
android:text="@string/ long app_name" 
android:textAppearance="?android: textAppearanceLarge" 
android:textSize="@dimen/menu text size"/> 


<Button 


android:id="@+id/continue button" 

android:layout width="match parent" 
android:layout height="wrap_content" 
android:layout margin="@dimen/menu button margin" 
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uy 








Dandroid:Layout width="wrap_content": 将 片段 设置 为 与 其 包含 的 内 容 等 宽 。 
口 android:layout height="wrap_content": 将 片段 设置 为 与 其 包含 的 内 容 等 高 。 
口 android:1layout_gravity="center": 将 片段 在 其 父 视图 中 居中 设置 。 该 属性 的 可 能 


可 














属性 设置 为 多 个 用 竖 线 
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android:padding="@dimen/menu_ button padding" 
android:text="@string/continue label"/> 


<Button 
android:id="@+id/new button" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:layout gravity="center" 
android:layout margin="@dimen/menu button margin" 
android:padding="@dimen/menu_ button padding" 
android:text="@string/new 9ame label"/> 





<Button 

android:id="@+id/about button" 

android:layout width="match parent" 

android:layout height="wrap content" 

android:layout gravity="center" 

android:layout margin="@dimen/menu button margin" 

android:padding="@dimen/menu_ button padding" 

android:text="@string/about label"/> 
</LinearLayout> 


其 中 很 多 行 都 显示 为 红色 。 不 用 担心 ,本章 后 面 将 修复 这 些 问题 


在 这 里 ， 要 将 4 个 元 素 排 成 一 列 ， 因 此 使 用 了 一 个 LinearLayout ， 并 将 其 android:ori- 
entation 属 性 设置 为 vertical。 在 这 个 线性 布局 内 部 ， 定 义 了 一 个 文本 视图 和 3 个 按钮 。 


在 Android 开 发 中 ， 文 本 视图 可 能 是 最 常见 的 用 户 界面 元 素 了 。 下 面 列 出 了 其 他 一 些 常 见 的 
界面 元 素 。 


口 Button: 按钮 控件 。 

口 CheckBox: 有 两 种 可 能 状态 的 按钮 ， 用 于 多 选 列表 中 。 
口 EditText: 可 编辑 的 文本 视图 。 

口 ImageButton: 显示 图 像 而 不 是 文本 的 按钮 。 

口 ListView: 在 可 固定 的 垂直 列表 中 显示 一 系列 列表 项 。 

口 RadioButton: 有 两 种 可 能 状态 的 按钮 ， 用 于 单 选 列表 中 。 
口 VideoView: 显示 视频 文件 。 

口 WebView: 显示 网 页 。 


要 获悉 完整 的 用 户 界 面 元 素 列表 ， 请 参阅 有 关 View 类 的 文档 "。 
1.LinearLayout 标 签 的 属性 
在 前 面 为 LinearLayout 标 签 设 置 的 届 



























































Wal 
入 


生 中 ， 尚 未 介绍 的 属性 如 下 。 


口 android:background="@drawable/menu_background": 设置 整个 视图 的 背景 drawable。 


























人 http://d.android.com/reference/android/view/View.html 
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drawable 可 以 是 颜色 、 图 形 或 XML 文件 定义 的 复合 对 象 ， 稍 后 将 对 其 进行 更 详细 的 介绍 。 
口 android:elevation="@dimen/elevation high": 令 视 图 比 画布 稍 高 。 在 Android 5.0 
( Lollipop ) 和 更 高 版 本 中 ， 这 将 导致 在 视图 下 方 绘制 阴影 。 如 果 运 行程 序 的 设备 使 用 的 
Android 版 本 较 旧 ， 就 像 其 他 无 法 识别 的 属性 一 样 ， 忽 略 该 属性 。 这 里 没有 使 用 数字 来 明 
确 指定 视图 要 比 画 布 高 多 少 ， 而 是 引用 了 一 个 将 在 另 一 个 XML 文 件 中 定义 的 尺寸 。 
口 android:orientation="vertical": 指定 布局 的 方向 ， 可 能 的 取 值 为 vertical (将 子 
视图 排 成 一 列 ) 和 horizontal (将 子 视图 排 成 一 行 )，、 如 果 要 将 子 视图 排 成 多 行 、 多 列 ， 
必须 使 用 其 他 布局 ， 如 GridLayout。 
口 android:padding="@dimen/menu padding": 让 Android 在 视图 内 部 留 出 少量 的 空间 。 
如 果 要 在 视图 外 部 留 出 空间 ， 可 使 用 属性 margin。 
间接 值 ( 如 @dimen/menu_padding ) 是 很 有 用 的 , 但 有 时 可 能 令 人 迷惑 。 此 时 Android Studio 
可 提供 帮助 ， 它 会 在 可 能 的 情况 下 在 编辑 器 中 显示 最 终 解析 得 到 的 值 。 间 接 值 被 定义 后 ,可 将 鼠 
标 指向 它 或 单 击 它 以 显示 原始 引用 ， 再 按 住 Ctrl 并 单 击 引用 以 查看 其 定义 。 

2. TextView 标 签 的 属性 
前 面 为 TextView 标 签 设置 了 如 下 属性 。 


Dandroid:Layout marginBottom="@dimen/menu_space": 在 文本 视图 和 按钮 之 间 留 出 

一 定 的 空间 。 

口 android:text="@string/long app_name": 指定 要 显示 的 文本 。 这 里 引用 了 将 在 文件 

strings.xml 中 定义 的 Long_app_name。 

口 android:textAppearance="?android:textAppearanceLarge": 让 文本 字体 比 常规 状 
态 更 大 、 更 粗 。? 表 示 引 用 了 当前 主题 中 定义 的 一 个 常量 。 主 题 定 义 了 数 百 个 常量 ， 用 于 
控制 应 用 中 每 个 视图 的 外 观 和 行为 。 更 详细 的 信息 请 参阅 3.5.5 节 。 

口 android:textSize="@dimen/menu text size": 即便 设置 了 属性 textAppearance， 
文本 看 起 来 还 不 够 大 ， 因 此 这 里 用 硬 编码 的 方式 指定 了 更 大 的 字号 。 

3. Button 标 签 的 属性 

为 Button 标 签 设置 如 下 属性 。 

Dandroid:tLayout_ margin="@dimen/menu_ button margin": 在 按钮 周围 留 出 一 些 额 外 

的 空间 。 

口 android:padding="@dimen/menu_button padding": 在 按钮 内 部 留 出 一 些 额外 的 

空间 。 

Dandroid:text="G@string/continue label": 指定 按钮 显示 的 文本 。 这 里 再 次 引用 了 
将 在 文件 strings.xml 中 定义 的 值 。 

对 于 前 面 所 有 以 6 打头 的 值 , 都 将 在 3.5$ 节 中 定义 。 下 面 先 来 编写 与 XML 协同 工作 的 Java 代 码 。 
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3.3 ”编写 代码 


定义 主屏 幕 和 片段 的 布局 后 ， 需 要 编写 一 些 Java 代 码 让 它们 显示 出 来 。 先 从 该 应 用 的 主 活 
MainActivity 类 开始 。 











动 





3.3.1 定义 主 活动 

在 org.example.tictactoe 包 中 ， 文 件 夹 java 下 应 该 有 一 个 名 为 MainActivity.java 的 文件 ， 它 是 在 
我 们 创建 项 目 时 由 Android Studio 创 建 的 。 现 在 ， 请 打开 它 。 为 此 ， 可 在 项 目 窗口 中 双击 它 ; 也 
可 选择 菜单 Navigate> File 或 按 其 快捷 键 ( 在 Windows 中 Ctrl+Shift+N ), 然后 输入 文件 名 。 接 下 来 ， 
将 其 中 的 所 有 代码 替换 为 如 下 内 容 。 








ticTacToev1/src/main/java/org/example/tictactoe/MainActivity.java 


Line1 package org.example.tictactoe; 


- import android.app.Activity; 

- import android.os.Bundle; 

5 

- public class MainActivity extends Activity { 


@Override 

protected void onCreate(Bundle savedInstanceState) { 
10 super.onCreate(savedInstanceState); 

setContentView(R.layout.activity main); 
} 
= 
这 是 本 书 第 一 次 介绍 Java 代 码 ， 因 此 将 逐 行 介绍 每 行 代码 的 功能 。 
第 1 行 定义 了 包 名 。 为 方便 访问 以 及 避免 名 称 冲 突 ， 将 Java 源 文件 收集 到 了 包 中 。 包 名 必须 
与 目录 名 匹配 。 
第 3 行 和 第 4 行 告诉 编译 器 ， 我 们 将 使 用 android.app 包 中 的 Activity 类 以 及 android.os 包 中 的 
Bundle 类 。 这 两 个 包 都 是 Android 框 架 提 供 的 标准 包 。 

从 第 6 行 开始 ， 是 MainActivity 类 的 定义 ， 它 是 Activity 类 的 子 类 。 关 于 活动 , 已 经 在 第 2 
章 中 讨论 过 。 

从 第 9 行 开 始 是 方法 onCreate() ， 它 是 活动 生命 周期 的 一 部 分 ， 在 活动 创建 时 被 调用 。 
Goverride 指 出 这 个 方法 最 初 是 在 Activity 类 中 定义 的 ， 但 我 们 将 给 它 提 供 新 的 定义 。 在 新 定 
义 中 ， 首 先 会 调用 旧 定 义 ， 如 第 10 行 所 示 。 

第 11 行 很 重要 ， 它 使 用 activity_main.xml 定 义 的 XML 布局 填充 活动 的 内 容 ， 用 来 演示 如 何 使 
用 前 面 声明 的 XML。 
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最 后 ,由 最 后 两 行 来 指定 代码 块 的 结束 位 置 。 所 有 的 代码 都 必须 正确 地 柑 套 ， 





报错 。 











下 面 来 定义 主 活动 使 用 的 片段 。 


3.3.2 ”定义 主 活动 使 用 的 片段 


在 3.2.1 节 中 ， 我 们 使 用 org .example.tictactoe.MainFragment 类 创建 了 一 个 片段 。 下 面 


来 定义 这 个 


首先 创建 文件 MainFragment.java。 为 此 ,找到 文件 MainActivityjava 并 复制 它 , 将 复制 的 文件 


类 。 


命名 为 MainFragment.java， 并 在 该 文件 打开 后 ， 将 其 所 有 代码 蔡 换 为 如 下 内 容 。 


ticTacToev1/src/main/java/org/example/tictactoe/MainFragment.java 


package org.example.tictactoe; 


import 
import 
import 
import 
import 
import 
import 


public 


android. 
android. 


android 


android 


app.AlertDialog; 
app.Fragment; 


.Ccontent.DialogInterface; 
android. 


0s.Bundle; 


.View.LayoutInflater; 
android. 
android. 


View.View; 
View.ViewGroup ; 


class MainFragment extends Fragment { 


private AlertDialog mDialog; 


@Ov 


erride 


public View onCreateView(LayoutInflater inflater, ViewGroup container, 


} 


View rootView = inflater.inflate(R.layout.fragment main, container, 


Bundle savedInstanceState) { 


// 在 这 里 添加 处 理 按钮 的 代码 …… 
return rootView; 


否则 编译 需 将 





false); 


这 个 类 的 结构 与 MainActivity 类 相似 , 但 片段 的 启动 方法 为 onCreateView( )。 这 个 方法 接 
受 3 个 参数 : 一 个 infLater 对 象 (可 用 于 将 XML 转换 为 视图 )、 一 个 指向 父 容器 的 引用 以 及 一 些 
保存 的 状态 。 我 们 不 需要 保存 的 状态 ， 而 只 调用 方法 infLater.infLate() ， 并 传人 
R.Layout .fragment_main ( 它 指向 前 面 定义 的 fragment main.xml )， 再 返回 该 方法 创建 的 视图 。 


这 个 主 片段 包含 3 个 按钮 ,分 别 月 








首先 来 实现 这 3 项 功能 中 最 简单 的 一 项 。 
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日 于 继续 游戏 、 开 始 新 游戏 以 及 查看 有 关 游 戏 的 信息 。 下 面 ， 
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3.4 湛 杰 加 Abo ut 框 


很 多 应 用 都 包含 一 个 这 样 的 按钮 ， 即 用 户 通过 它 可 以 获悉 有 关 应 用 的 更 详细 信息 或 帮助 。 你 
可 能 希望 在 用 户 点 击 该 按钮 时 显示 参与 程序 开发 的 所 有 人 员 、 使 用 的 开源 包 或 其 他 法 律 信息 。 在 
这 个 示例 中 , 我 们 要 在 用 户 点 击 About 按 钮 时 显示 两 个 段落 ， 用 来 指出 这 个 游戏 的 玩法 ， 如 图 3-3 


所 示 。 
About Ultimate Tic Tac Toe 


This game is played just like regular Tic 
Tac Toe with one difference: to win a tile 
you have to win a smaller game of Tic 
Tac Toe inside that tile. 














A tie happens when there are no further 
moves. In the case of a tie in a small 
board, that will count as a win for both 
sides in the larger game. 


OK 








图 3-3 


为 此 ,需要 在 片段 的 方法 onCreateView() 中 添加 几 行 代码 , 即 在 返回 rootView 的 代码 前 面 ， 
添加 如 下 代码 。 


ticTacToev1/src/main/java/org/example/tictactoe/MainFragment.java 
Line 1 // 处 理 按钮 的 代码 ……: 
- View aboutButton = rootView.findViewById(R.id.about button); 
- aboutButton.setOnClickListener(new View.0nCLickListener() { 
@Override 
5 public void onClick(View view) { 
AlertDialog.Builder builder = 
new AlertDialog.Builder(getActivity()); 
builder.setTitle(R.string.about title); 
builder.setMessage(R.string.about text); 
10 builder.setCancelable(false); 
builder.setPositiveButton(R.string.ok label, 
new DialogInterface.OnClickListener() { 


@Override 
- public void onCLick(DiaLogInterface dialogInterface, 
15 int i) { 

// 这 个 方法 为 空 
} 
}); 

- mDialog = builder.show(); 
20 } 
- }); 
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第 2 行 负责 获取 片段 视 











图 中 的 About 按 钮 ， 然 后 由 第 3 行为 它 设 置 点 击 监听 器 。 月 
钮 时 ， 将 调用 监听 器 的 方法 onClick() (第 5 行 )。 


























日 户 轻 按 该 按 
第 6 行 用 于 创建 一 个 新 的 ALertDiatog.Buitder 实 例 ,， 并 将 当前 活动 作为 参数 传人 。 接 下 
来 ， 从 第 8 行 开始 ， 设 置 对 话 框 的 标题 和 消息 内 容 。 第 10 行 调用 了 setCancelable()， 使 得 
Android 不 会 在 用 户 轻 按 对 话 框 外 面 时 关闭 它 。 第 11 行 在 对 话 框 中 添加 了 一 个 OK 按钮 ， 但 它 没 
有 任何 用 途 。 
定义 完 对 话 框 后 ， 第 19 行 负责 将 其 显示 出 来 。 








还 有 一 项 工作 要 做 。 我 们 要 在 包含 该 片段 的 活动 暂停 ( 如 启动 了 另 一 个 应 用 ) 时 ， 将 Abonut 

框 关 闭 。 为 此 ， 应 在 MainFragment 类 中 添加 如 下 onPause() 方 法 。 
ticTacToev1/src/main/java/org/example/tictactoe/MainFragment.java 
GOverride 


public void onPause() { 
super.onPause(); 


// 如 果 About 对 话 框 未 关闭 ， 就 将 其 关闭 
if (mDialog != null) 


mDialog.dismiss(); 
} 











至 此 ，MainFragment 包 含 了 两 个 方法 : onCreateView() 和 onPause()。 如 果 
请 确保 所 有 的 大 括号 都 匹配 。 如 果 依 然 有 问题 

















编译 需 报 错 ， 
请 从 本 书 配套 网 站 "下 载 完 整 的 源 代码 文件 。 
3.5 ”定义 资源 


几乎 所 有 的 资源 都 是 使 用 XML 定义 的 (参见 2.2.7 节 )。 在 编译 阶段 ， 对 XML 进行 了 预 编 
这 样 ， 程 序 在 运行 时 不 会 因为 分 析 XML 而 降低 性 能 。 


3.5.1 字符 






































译 。 
字符 串 
在 程序 代码 和 布局 中 , 不 以 硬 编 码 的 方式 指定 文本 字符 串 , 而 是 将 所 有 的 文本 字符 串 都 存储 
在 一 个 地 方 文件 夹 res/values 中 的 资源 文件 strings.xml。 这 样 , 在 需要 将 应 用 推 向 外 国 市 场 时 ， 
翻译 这 些 字 符 串 的 工作 将 容易 得 多 。 在 程序 Tic-Tac-Toe 中 ， 当 前 所 使 用 的 字符 串 如 下 : 
ticTacToev1/src/main/res/values/strings.xml 
<?xml version="1.0" encoding="utf-8"?> 


<string name="app_name">UT3</string> 





<string name="long app_name">Ultimate Tic Tac Toe</string> 


GD http://pragprog.com/book/eband4 
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<string name="action settings">Settings</string> 
<string name="continue label">Continue</string> 
<string name="new game label">New Game</string> 
<string name="about label">About</string> 
<string name="ok label">0K</string> 
<string name="about title">About Ultimate Tic Tac Toe</string> 
<string name="about text">\ 
This game is played just like regular Tic Tac Toe with one difference: to 
win a tile you have to win a smaller game of Tic Tac Toe inside that tile.\n\ 
\n\ 
A tie happens when there are no further moves. In the case of a tie in a small 
board, that will count as a win for both sides in the larger game. 
</string> 
</resources> 


每 项 资源 都 有 名 称 和 值 。 在 Java 代 码 或 XML 中 ， 将 名 称 用 作 id 来 引用 资源 。 例 如 ， 在 Java 代 
码 中 , R.string.app_name 为 资源 app_name 的 id。 要 获取 实际 字符 串 , 必须 调用 另 一 个 函数 (如 
Activity.getString() )， 并 传人 相应 的 id。 在 XML 中 ， 情 况 更 简单 些 ， 只 需 使 用 6， 并 在 其 后 
面 指定 资源 类 型 和 名 称 即 可 ， 如 @string/app_name。 


在 8.3.1 节 ， 将 介绍 如 何 指定 替代 资源 。 








3.5.2 尺寸 


尺寸 资源 可 用 于 任何 需要 指定 长 度 的 地 方 。 所 有 尺寸 资源 都 放 在 一 个 尺寸 文件 (文件 夹 
res/Values 下 的 文件 dimens.xml ) 中 ， 这 样 有 助 于 在 不 修改 代码 的 情况 下 支持 不 同 尺 寸 的 Android 
设备 。 到 目前 为 止 ， 我 们 的 应 用 使 用 了 如 下 尺寸 。 











ticTacToev1/src/main/res/values/dimens.xml 


<resources> 
<dimen name="elevation high">8dp</dimen> 
<dimen name="stroke width">1ldp</dimen> 
<dimen name="corner_radius">4dp</dimen> 
<dimen name="menu padding">10dp</dimen> 
<dimen name="menu_ space">10dp</dimen> 
<dimen name="menu_text_ size">32sp</dimen> 
<dimen name="menu button margin">4dp</dimen> 
<dimen name="menu_button padding">10dp</dimen> 
</resources> 


eh ， 请 参阅 3.5.6 节 。 


你 可 能 会 看 到 两 个 版 本 的 dimens.xml 文 件 : 常规 版 本 和 使 用 w820dp 标 记 的 版 本 。 目 前 只 使 用 
常规 版 本 ， 另 一 个 版 本 用 于 宽屏 设备 的 蔡 代 资源 。 有 关 替 代 资 源 ， 将 在 8.3.1T 讨 论 。 














3.5.3 drawable 
drawable 指 的 是 可 在 屏幕 上 绘制 的 任何 图 形 对 象 。 位 图 是 最 简单 的 drawable， 通 常 以 PNG 或 
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JPG 格 式 存 储 。 在 主屏 幕 上 ， 应 用 的 启动 图 标 就 是 位 图 。 














还 可 以 使 用 XML 来 创建 drawable。 下 面 是 用 作 主 屏幕 中 选项 的 背景 drawable 的 定义 ， 它 被 放 


置 在 文件 夹 res/drawable 中 。 


源 


> 


ticTacToev1/src/main/res/drawable/menu_background.xml 


<?xml version="1.0" encoding="utf-8"?> 
<shape 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
android:color="@color/border color"/> 
<solid android:color="@color/field color"/> 
<corners android:radius="@dimen/corner_radius"/> 
</shape> 


该 XMIL 文 件 定义 了 一 个 矩形 形状 ,该 形状 带 圆 角 并 使 用 纯色 填充 。 注 意 到 它 引 用 了 其 他 资 
以 指定 描 边 的 宽度 和 颜色 、 填 充 色 以 及 圆 角 半径 。 

这 也 可 以 使 用 位 图 来 实现 ， 但 使 用 XML 具有 如 下 优点 : 图 形 是 基于 矢量 的 ， 支 持 任意 分 辩 
这 意味 着 不 管 将 该 背景 放大 到 多 大 ， 它 都 是 清晰 的 ， 不 会 导致 像素 化 。 


下 面 是 最 常见 的 drawable 类 型 。 


口 位 图 文件 : PNG、JPG 或 GIF 格式 的 图 片 。PNG 位 图 可 以 是 半 透 明 的 。 

口 九宫 格 (Nine-patch ) 文件 : 包含 可 拉 伸 区 域 的 PNG 图 片 ， 支 持 根据 内 容 调 整 大 小 。 
口 图 层 列表 ( Layer list ) : 一 系列 按 顺序 绘制 的 drawable。 

口 状态 列表 ( State list ) : 一 系列 drawable， 根 据 状态 显示 不 同 的 drawable。 

口 等 级 列表 (Level list ) : 一 系列 drawable， 根 据 等 级 值 显示 不 同 的 drawable。 

口 形状 : 由 线条 和 颜色 组 成 的 几何 形状 。 


有 关 drawable 类 型 及 其 属性 的 完整 列表 ， 请 参阅 在 线 文档 "。 














nl 






































3.5.4 颜色 





下 面 是 前 面 的 背景 资源 使 用 的 颜色 的 定义 。 


ticTacToev1/src/main/res/values/colors.xml 
<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<color name="field color">#b5cee0</coLor> 
<color name="border color">#7f7f7f</color> 
</resources> 





GD http://d.android.com/guide/topics/resources/drawable-resource.html 
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在 Android 中 ,颜色 是 以 护 RGGBB 或 #AARRGGBB 的 形式 指定 的 。 其 中 ,， RR、GG、BB 分 别 
以 十 六 进 制 的 方式 指定 了 红色 、 绿 色 和 蓝 色 组 分 ，AA 为 alpha 组 分 。 这 些 十 六 进 制 数 字 的 取 值 范 
围 为 00 (0) ~FF (255 )。 例 如 ， 考 F0000 表 示 纯 红色 ， 而 姓 FFFFF 表 示 白 色 。 

alpha 组 分 是 可 选 的 ， 表 示 颜 色 的 透明 度 ， 取 值 范围 为 0 ( 完全 透明 ) ~ 255 ( 完全 不 透明 )。 
如 果 没 有 设置 alpha 组 分 ， 颜色 将 是 完全 不 透明 的 。 


























3.5.5 ”样式 和 主题 
样式 和 主题 在 决定 应 用 的 外 观 方面 扮演 着 重要 角色 。 主题 是 一 系列 样式 , 而 样式 是 一 系列 控 
制 外 观 和 行为 的 值 。 如 果 你 打开 文件 AndroidManifest.xml， 将 看 到 下 面 一 行 。 
android:theme="@style/AppTheme" 


它 引 用 了 styles.xml 中 所 定义 的 样式 AppTheme。 请 按 住 Ctrl 键 并 单 击 AppTheme 以 打开 文件 
styles.xml， 然 后 将 该 文件 做 如 下 修改 。 






































ticTacToev1/src/main/res/values/styles.xml 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<!-- 应 用 的 基本 主题 - -> 
<style name="App Theme" 
parent="android:Theme.Holo.Light.NoActionBar.Fullscreen"> 
<!-- 在 这 里 定制 主题 - -> 
</style> 
</resources> 


主题 定义 了 数 百 个 值 ， 因 此 通常 会 使 用 定义 好 的 主题 ,并 修改 其 中 的 几 个 值 。 为 指定 现成 的 
主题 ， 可 使 用 属性 parent。 在 这 里 ,我们 使 用 了 顶部 没有 标题 栏 的 主题 ， 以 便 让 活动 覆盖 整个 
屏幕 。 

要 查看 所 有 可 用 的 主题 ， 可 在 Android Studio 编 辑 器 中 将 光标 放 在 android:Theme. 后 面 ， 再 
按 Ctrl+ 空 格 键 。 应 用 运行 后 ， 你 可 能 希望 回 过 头 来 使 用 不 同 的 主题 ， 看 看 它们 如 何 影响 应 用 。 









































3.5.6 dp 和 sp 
以 前 ， 程 序 员 设 计 计 算 机 界面 时 总 是 以 像素 为 单位 。 例 如 ， 可 能 将 文本 框 的 宽度 设置 为 300 
像素 , 将 列 间距 设置 为 5 像素 , 将 图 标 大 小 指定 为 16x16 像 素 。 这 样 做 之 后 带 来 的 问题 是 , 运行 程 
序 时 ,设备 屏幕 的 每 英寸 点 数 ( dpi ) 越 多 ， 界 面 越 小 。dpi 高 到 一 定 程度 后 ， 将 很 难看 清 界面 。 
为 帮助 解决 这 种 问题 ， 可 使 用 独立 于 分 辩 率 的 度量 单位 。Android 支 持 如 下 度量 单位 。 
口 px (像素 ): 屏幕 上 的 点 。 
口 in (英寸 ) 用 标尺 量度 的 尺寸 。 
口 mm (毫米 ): 用 标尺 量度 的 尺寸 。 
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口 pt ( 磅 ): 1/72 英 寸 。 
D dp( 密度 无 关 像素 ) 基于 屏幕 密度 的 抽象 单位 。 在 160 dpi 屏 幕 上 ,1 dp = 1 px。 
D dip : 含义 与 dp 相同 。 
D sp (比例 无 关 像 素 ): 类 似 于 dp ， 可 根据 用 户 的 字号 首选 项 设置 进行 缩放 。 
为 了 让 界面 能 够 适应 当前 和 未 来 的 屏幕 类 型 ， 建 议 在 指定 文本 大 小 时 以 sp 为 单位 ， 而 指定 其 
他 内 容 的 大 小 时 都 以 dp 为 单位 。 在 任何 时 候 ， 都 不 要 以 像素 ( px ) 为 单位 。 



































3.5.7 ”运行 游戏 

万 事 俱 备 ， 现 在 可 以 运行 这 个 游戏 了 。 为 此 ， 可 选择 菜单 Run>Run 'app'、 单 击 工具 栏 上 的 
Run 按 钮 或 使 用 快捷 键 ( 在 Windows 中 为 ShifttF10 )。 与 运行 “Hello, Android” 程 序 时 一 样 ， 这 里 
会 要 求 你 选择 设备 。 可 以 选择 模拟 器 ， 也 可 以 选择 通过 USB 连 接 到 计算 机 的 实际 设备 。 

如 果 一 切 顺 利 ， 你 将 看 到 类 似 于 图 3-2 所 示 的 屏幕 。 如 果 你 点 击 按钮 Continue 或 New Game， 
什么 都 不 会 发 生 ( 这些 功能 将 在 下 一 章 添加 );， 而 如 果 你 点 击 About 按 钮 ， 将 出 现 About 对 话机 
请 点 击 OK 按钮 将 其 关闭 。 


















































ml 








上 一， 


1 。 小 乔 爱 间 : 
过 如何 退 出 呢 ? 


你 可 能 注意 到 了 ,这 个 游戏 没有 退出 按钮 。 这 是 因为 根本 束 不 需要 这 种 按钮 。 如 果 添 加 
这 种 按钮 ， 反 合 有 悖 于 Android 设计 指南 "。 要 退出 游戏 ， 只 需 按 返回 按钮 或 主屏 幕 按钮 ， 
也 可 按 近 期 使 用 的 应 用 (Recent Apps) 按钮 ， 并 从 列表 中 选择 其 他 应 用 。 

你 可 能 担心 这 会 让 程序 继续 运行 。 根 本 没 必 要 。 在 其 他 程序 需要 资源 时 ，Android 将 终 
止 该 程序 ， 并 收回 它 占用 的 资源 。 要 强行 终止 程序 ， 可 按 近 期 使 用 的 应 用 (Recent Apps) 按 
钮 ， 并 轻 扫 它 。 这 不 仅 会 将 应 用 从 列表 中 删除 ,还 将 终止 它 并 收回 它 占 用 的 资源 。 在 开发 阶 
段 ， 当 运行 了 多 个 存在 bug 的 程序 时 ， 这 是 很 有 用 的 。 但 是 ， 在 大 多 数 情 况 下 ， 完 全 没有 必 
要 这 样 做 。 





1. http://d.android.com/design 


3.6 调试 


如 果 你 有 编程 经 验 ， 青 定 知道 在 大 多 数 时 候 ， 你 并 不 能 如 愿 以 偿 。 在 这 种 情况 下 ,该 怎么 办 
呢 ? 所 幸 ， 在 其 他 平台 上 使 用 的 调试 手法 也 适用 于 Android， 包 括 将 消息 打印 到 日 志 以 及 在 调试 
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器 中 以 步 进 方式 执行 程序 。 


3.6.1 使 用 日 志 消息 进行 调试 
Log 类 提供 了 多 个 静态 方法 ， 可 用 于 将 各 种 等 级 的 消息 打印 到 Android 系 统 日 志 。 


口 Log.e(): 错误 。 
口 Log .w 警告 。 


口 Log.i(): 提示 。 
口 Log.d(): 调试 。 
口 Log.v(): 详情 (Verbose )。 
口 Log .wtf(): 致命 错误 。 

用 户 永远 都 看 不 到 系统 日 志 ， 但 开发 人 员 可 以 两 种 方式 查看 它 。 在 Android Studio 中 ， 程 序 
运行 时 ，LogCat 视 图 将 出 现在 窗口 底部 ， 如 图 3-4 所 示 。 为 减少 显示 的 内 容 ， 可 将 日 志 等 级 设置 
为 除 Verbose 外 的 其 他 值 ， 也 可 在 筛选 文本 框 中 输入 一 个 字符 串 。 


() 
(): 
() 
() 











Android DDMS 琳 " 二 
回 Devices | logcat ADB logs +*" [| Log level: IVerbose | -| @Q- [app: org.example.tictactoe | -| 
声 , Devices i logcat + 





| 国 Emulator Nexus 5 APL21 yx66 Android5 攻 3 命 03-01 12:19:43.657 2601-2601/0rg.example.tictactoe I/art: Not late-enabling -Xcheck:j: 
了 03-01 12:19:43.845 2601-2616/0rg.example.tictactoe D/OpenGLRenderer: Render dirty reg: 
2601-2601/org.example.tictactoe D/: HostConnection::get() New Host 
。 2601-2601/org.example.tictactoe D/Atlas: Validating map... 
03-01 12:19:44.015 2601-2616/0rg.example.tictactoe D/: HostConnection::get() New Host 
com.android.defcontainer (1737 03-01 12:19:44.052 2601-2616/0rg.example.tictactoe I/OpenGLRenderer: Initialized EGL, 
Com.android desisdock (1909 可 03-01 12: 44.210 2601-2616/0rg.example.tictactoe D/OpenGLRenderer: Enabling debug mt 
pe 03-01 12:19:44.252 2601-2616/0rg.example.tictactoe W/EGL emulation: eglSurfaceAttrib 1 
com.android.inputmethod.latin (1476) BB 03-01 12:19:44.252 2601-2616/org.example.tictactoe W/OpenGLRenderer: Failed to set EG] 
com.android,keychain (2770) 






org.example.tictactoe (2879) [E 
android.process.acore (1651) 





android,process.media (269 





samn_ ancienicd haemeihoe (1571 


贺 685:36 CRLF ? UTF-8 /白人 县 








请 在 程序 中 输入 类 似 如 下 的 代码 行 。 

Log.d("UT3", "Got to point A"); 

这 样 ， 下 次 运行 程序 时 将 在 日 志 中 看 到 它们 。 

如 果 你 使 用 的 不 是 Android Studio ， 可 采用 如 下 方法 查看 这 种 输出 : 切换 到 SDK 安 装 目录 下 
的 文件 夹 platform-tools， 并 运行 命令 adb Logcat”。 你 可 能 会 在 一 个 独立 的 窗口 中 运行 这 个 命令 ， 
并 在 模拟 器 运行 或 设备 连接 期 间 始 终 打 开 这 个 窗口 。 这 不 会 影响 其 他 任何 监视 工作 。 

在 开发 期 间 ， 要 特别 强调 Android 日 志 的 重要 性 。 每 当 遇 到 意外 的 错误 时 ， 都 请 先 查 看 日 志 。 
十 有 八 九 你 都 可 以 通过 它 获得 足够 的 信息 ， 进 而 将 问题 排除 ， 而 无 需 使 用 重 武器 一 一 调试 器 。 









































QD http://d.android.com/tools/help/adb.html 
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3.6.2 ”使 用 调试 器 进行 调试 
Android Studio 提 供 了 一 个 调试 器 ， 它 是 排除 Android 程 序 中 的 问题 的 终极 方式 。 要 启动 调试 


器 ,请 选择 菜单 Run> Debug ( 而 不 是 Run> Run ), 也 可 以 单 击 工具 栏 中 的 “调试 ”按钮 或 使 用 快 
捷 键 (Windows 中 为 Shift+F9 )。 


在 启用 了 调试 器 的 情况 下 运行 时 , 应 用 在 发 生 异 常 或 到 达 断 点 时 都 将 停止 运行 。 断 点 类 似 于 
禁 行 标志 , 可 在 代码 中 放置 它们 。 为 此 , 需要 在 Java 编 辑 器 中 , 单 击 要 暂停 的 代码 行 左边 的 gutter， 
单 击 处 将 出 现 一 个 红色 图 标 。 下 次 程序 运行 到 相应 代码 行 时 将 暂停 执行 。 

暂停 执行 后 ， 屏 幕 底部 将 出 现 调试 窗口 ， 如 图 3-5 所 示 。 其 中 显示 了 当前 位 置 以 及 所 有 变量 
的 值 。 



































Debug 唤 ' app 覃 s 点 
所 Debugger 区 Console +” 唱 ' Logcat +*" 许 唱 6 Yi 图 如 
> i a 
局 Frames *” 顾 Threads *| 去 Variables » 
[网 "main"@3,563 in group "... 7 三 this = {org.example.tictactoe.MainFragment$1@3610} 
onClick0:25, MainFragmentSl (org.example.t 三 view = "android.widget.Button{3e965f7c VFED..C. ...P.... 42,537 
ER 56 View fond 三 mBoring = "FontMetricsInt: top=-58 ascent=- 


mBufferType = "NORMAL” 
mChangeWatcher = null 
mCharWrapper = null 


mCurrentSpellCheckerLocaleCache = null 


mDrawables = null 


一 期 罗 [NW RY 
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图 3-5 
在 这 个 窗口 中 ， 你 可 以 检查 变量 和 类 成 员 、 查 看 到 达 当 前 位 置 的 调用 序列 (追踪 )、 继 续 往 
下 执行 到 下 一 个 断 点 或 以 每 次 一 行 的 方式 执行 程序 。 


3.6.3 测试 


除 即 兴 测 试 ( 即 测试 程序 能 否 正 常 运 行 ) 外 ,强烈 建议 尽 可 能 使 用 自动 测试 。 可 以 运行 各 种 
测试 ， 最 常见 的 测试 如 下 。 
口 单元 测试 ": 检查 程序 的 低级 功能 。 单 元 测试 基于 JUnit 框 架 *，Android Studio 和 gradle 都 为 
单元 测试 提供 了 支持 。 
口 用 户 界 面 测试 ”: 检查 用 户 界 面 能 否 正常 运行 。 通 常 使 用 脚本 语言 来 与 用 户 界面 进行 一 系 
列 交互 。 











GD http://d.android.com/tools/testing/testing android.html 
© http://junit.org 
© http://d.android.com/tools/testing/testing_ui.html 
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口 猴子 测试 ": 使 用 随机 输入 对 程序 狂 又 乱 炸 ， 试 图 破坏 它 。 这 犹如 数 千 只 猴子 排 成 队 ， 依 
次 随机 地 点 击 屏幕 上 的 按钮 ， 直 到 程序 骨 溃 。 
虽然 进行 自动 测试 不 容易 , 但 它们 对 专业 项 目 来 说 必 不 可 少 。 全 面 讨论 自动 测试 超出 了 本 书 
的 范围 ， 网 上 有 大 量 有 关 这 方面 的 教程 和 指南 。 














3.7 ”快速 阅读 指南 

本 章 介 绍 的 内 容 很 多 。 你 白手 起 家 ， 使 用 了 布局 文件 来 组 织 用 户 界 面 ， 并 使 用 Android 资 源 
来 提供 文本 、 颜 色 等 。 你 还 创建 了 表示 活动 和 片段 的 Java 类 ， 并 添加 了 按钮 和 文本 框 等 控件 。 

Android 是 个 复杂 的 系统 ， 但 无 需 全 面 了 解 它 就 可 开始 编程 。 需 要 帮助 时 ， 可 参阅 数 百 页 在 
线 参 考 资料 ， 它 们 更 深入 地 介绍 了 所 有 的 类 和 方法 。 

要 查看 在 线 文 档 ， 可 打开 Android SDK 安 装 目录 下 的 子 目 录 docs ， 也 可 以 通过 浏览 圳 访问 
http:/d.android.com。 当 然 ， 每 当 你 遇 到 困难 时 ， 都 可 以 访问 本 书 配套 的 在 线 论坛 ”。 

其 他 读者 和 作者 将 很 乐意 帮 你 摆脱 困境 。 另 一 个 不 错 的 资源 是 Stack Overflow”， 也 可 以 使 用 
Google 进 行 搜索 。 


信 不 信和 由 你 ,即便 在 Google 和 网 络 面世 前 ， 人 们 也 能 编写 程序 。 但 现在 如 果 没 有 网 络 ， 做 什 
么 事情 都 难 上 加 难 。 这 也 是 提倡 购买 大 量 图 书 的 为 一 个 原因 1 



































QD http://d.android.com/tools/help/monkey.html 
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前 一 章 创 建 了 一 个 终极 版 井 字 游戏 , 并 为 之 实现 了 开始 屏幕 。 还 有 哪些 没有 实现 呢 ? 游戏 部 
分 。 我 们 将 分 两 音 完 成 这 项 任务 。 在 本 音 中 , 我们 将 创建 该 游戏 的 用 户 界面 。 你 将 能 够 与 另 一 个 
人 交替 地 使 用 你 的 手机 或 平板 电脑 来 一 起 玩 这 款 游戏 。 在 下 一 章 , 我 们 将 让 这 款 游戏 能 够 思考 并 
下 棋 ， 让 你 能 够 一 个 人 玩 。 


















































4.1 棋盘 


为 创建 棋盘 ， 我 们 将 从 最 小 的 部 分 着 手 ， 一 步 一 步 处 理 越 来 越 大 的 部 分 。 你 也 可 以 根据 你 
的 思维 方式 ， 从 顶级 对 象 着 手 往 下 处 理 。 怎 么 做 由 你 决定 , 但 对 于 我 来 说 ， 这 里 采用 的 做 法 是 
最 佳 的 。 

















4.1.1 从 小 处 着 手 


首先 ， 回 过 头 去 看 一 下 图 3-1， 想 想 要 实现 它 该 如 何 做 。 你 首先 想到 的 是 什么 ?也许 是 符号 X 
和 0O 如 图 4-1 所 示 )， 咱 们 先 来 处 理 它们 。 









































图 4-1 





你 可 以 自己 制作 这 些 符 号 ， 也 可 以 从 本 书 配套 网 站 "下 载 (它们 位 于 示例 代码 ticTacToev2 
中 )。 我 使 用 免费 编辑 器 Inkscape2 创 建 了 x_blue.png 和 o red.png, 并 将 它们 保存 成 了 非常 大 ( 128 








GD http://pragprog.com/book/eband4 
© http:/www.inkscape.org 
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像素 x128 像 素 ) 的 PNG 文 件 。 可 将 PNG 文 件 的 背景 设置 为 透明 或 半 透 明 的 ,这 样 可 将 其 放 在 其 
他 图 形 的 上 面 。 

这 些 文件 存储 在 目录 drawable-xxhdpi 中 , 其 中 的 后 缀 xxhdpi 表 示 超 高 ( extra extra high ) 密度 ， 
即 大 约 400 点 每 英寸 。 Android 设 备 还 可 能 装备 中 、 高 和 极 高 密度 的 屏幕 ，Android 会 在 必要 时 自动 
缩放 图 像 。 你 可 以 为 每 种 屏幕 密度 创建 一 组 位 图 ,但 就 这 个 游戏 而 言 ， 那样 有 点 小 题 大 做 。 有 关 
该 资源 目录 名 指定 后 级 的 更 详细 信息 ， 请 参阅 8.3.1 节 。 

在 Android Studio 中 ， 要 创建 目录 ， 可 右 击 父 目录 (这 里 为 res )， 青 选择 New>Directory， 然 
后 输入 目录 名 。 也 可 以 使 用 Android 资 源 目 录 向 导 ， 但 我 发 现 最 简单 的 方式 就 是 最 好 的 。 项 目 窗 
口 的 默认 模式 为 Android, 在 这 种 模式 下 ,看 不 到 目录 drawable-xxhdpi, 但 它 确实 存在 。 如 果 你 尝 
试 将 文件 粘贴 到 文件 夹 drawable 中 ， 系 统 将 要 求 你 指定 目标 目录 。 

考虑 到 对 XML 的 介绍 还 不 充分 , 这 里 将 这 些 图 像 封 装 到 一 个 名 为 tile.xml 的 drawable 中 。 前 面 
说 过 ，XML drawable 存 储 在 目录 drawable 中 。 这 个 drawable 的 定义 如 下 。 

































































ticTacToev2/src/main/res/drawable/tile.xml 


<?xml version="1.0" encoding="utf-8"?> 
<LeveL-List xmlns:android="http://schemas.android.com/apk/res/android" > 
<item 
android:drawable 
android:maxLevel 
<item 
android:drawabl 
android:maxLeve 
<item 
android:drawabl 
android:maxLeve 
<item 
android:drawabl 
android:maxLevel 
</LeveL-List> 


每 个 格子 都 有 4 种 可 能 的 等 级 : X、O 、 空 和 可 下 ( Available )。 等 级 X 和 0 很 容易 处 理 ， 它 们 
分 别 显示 刚才 创建 的 位 图 x_blue 和 o_red。 下 面 是 格子 为 空 时 显示 的 drawable 的 定义 。 


"@drawable/x_blue" 
"0" /> 


(qo 


r 
是 


"@drawable/o_red" 
"1" /> 


(0 


r 
中 


"@drawable/tile empty" 
"2" /> 


(0 


"@drawable/tile available" 
"3" /> 























ticTacToev2/src/main/res/drawable/tile_empty.xml 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
android:color="@color/dark border color"/> 
<corners android:radius="@dimen/corner_radius"/> 
</shape> 


它 定义 了 一 个 带 有 深 色 边框 的 圆 角 矩形。 格子 可 下 时 显示 的 drawable 与 此 类 似 , 但 内 部 使 用 
了 绿色 (这 是 通过 引用 指定 的 ) 进行 填充 。 
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ticTacToev2/src/main/res/drawable/tile_available.xml 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 


<stroke 


android:width="@dimen/stroke width" 

android:color="@color/dark border color"/> 
<solid android:color="@color/available color"/> 
<corners android:radius="@dimen/corner_radius"/> 


</shape> 


对 于 屏幕 上 的 全 部 81 个 格子 ， 都 将 使 用 tile.xml， 但 可 以 通过 设置 等 级 ， 


能 外 观 中 的 一 种 。 


4.1.2 ”小 棋盘 























让 它们 呈现 出 4 种 可 


小 棋盘 由 排列 成 3x3 网 格 的 9 个 格子 组 成 ,我 们 通过 指定 行 号 和 列 号 让 每 个 格子 出 现在 正确 的 
地 方 。 请 注意 ， 这 些 索引 从 0 开始 。 


ticTacToev2/src/main/res/layout/small_board.xml 


<GridLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="wrap_ content" 

android:layout height="wrap content" 
android:background="@drawable/tile background" 
android:elevation="@dimen/elevation low" 
android:padding="@dimen/small board padding" 
tools:context=",GameActivity"> 


<ImageButton 
<ImageButton 
<ImageButton 
<ImageButton 
<ImageButton 
<ImageButton 
<ImageButton 
<ImageButton 
<ImageButton 


</GridLayout> 


android 


android: 
android: 
android: 
android: 


android 
android 


android: 
android: 
android: 
android: 
android: 
android: 


android 
android 
android 


android: 
android: 


:id="@+id/small1" style="@style/TileButton" 
layout column="0" android:layout row="0"/> 
id="@+id/small2" style="@style/TileButton" 
layout column="1" android:layout row="0"/> 
id="@+id/small3" style="@style/TileButton" 
:layout column="2" android:layout row="0"/> 
:id="@+id/small4" style="@style/TileButton" 
layout column="0" android:layout row="1"/> 
id="@+id/small5" style="@style/TileButton" 
layout column="1" android:layout row="1"/> 
id="@+id/small6" style="@style/TileButton" 
layout column="2" android:layout row="1"/> 
id="@+id/small7" style="@style/TileButton" 
:layout column="0" android:layout row="2"/> 
:id="@+id/small8" style="@style/TileButton" 
:layout column="1" android:layout row="2"/> 
id="@+id/small9" style="@style/TileButton" 
layout column="2" android:layout row="2"/> 
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每 个 格子 都 是 一 个 ImageButton。 你 可 能 猜 到 了 ，ImageButton 是 图 像 和 按钮 的 混合 体 。 它 
是 可 点 击 的 图 像 ， 因 为 我 们 需要 让 玩家 通过 点 击 来 下 棋 。 

对 于 每 个 ImageButton， 都 指定 了 行 号 和 列 号 ， 还 指定 了 样式 TileButton。 为 定义 这 种 样 
式 ， 请 打开 文件 styles.xml， 并 在 结束 标签 </resources> 前 面 添 加 如 下 代码 。 























ticTacToev2/src/main/res/values/styles.xml 


<style name="TileButton"> 
<item name="android: layout width">@dimen/tile size</item> 
<item name="android: layout height">@dimen/tile size</item> 
<item name="android: layout_ margin">@dimen/tile margin</item> 
<item name="android:background">#00000000</item> 
<item name="android:padding">@dimen/tile padding</item> 
<item name="android:scaleType">centerCrop</item> 
<item name="android:src">@drawable/tile</item> 

</style> 


这 里 为 何 要 使 用 样式 呢 ? 必须 承认 ,可 以 不 这 样 做 ,但 我 讨厌 不 断 输入 相同 的 值 。 这 样 做 并 
不 是 想 偷 懒 ， 而 是 遵循 不 自我 重复 (DRY，Don’t Repeat Yourself ) 原则 。 有 关 DRY 原 则 和 其 他 编 
阻 技巧 的 更 详细 信息 ， 请 参阅 《程序 员 修炼 之 道 : 从 小 工 到 专家 》( The Pragmatic Programmer ) 
[HT99]。 









































2 





4.1.3 背景 信息 


你 可 能 注意 到 了 ， 小 棋盘 的 定义 中 包含 如 下 代码 行 。 


android:background="@drawable/tile background" 


这 是 做 什么 的 呢 ? 如 果 你 回 过 头 去 看 图 3-1 所 示 的 屏幕 截图 ， 将 发 现 每 个 小 棋盘 都 有 状态 ， 
就 像 每 个 格子 一 样 。 


tile_ background.xml 的 定义 如 下 。 


























ticTacToev2/src/main/res/drawable/tile_background.xml 


<?xml version="1.0" encoding="utf-8"?> 
<LeveL-List xmlns:android="http://schemas.android.com/apk/res/android"> 
<item 
android:drawable="@drawable/tile blue" 
android:maxLevel="0"/> 
<item 
android:drawable="@drawable/tile red" 
android:maxLevel="1"/> 
<item 
android:drawable="@drawable/tile gray" 
android:maxLevel="2"/> 
<item 
android:drawable="@drawable/tile purple" 
android:maxLevel="3"/> 
</LeveL-List> 
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我 们 用 蓝 色 表示 小 棋盘 被 玩家 X 占 据 ， 用 红色 表示 小 棋盘 被 玩家 0 占据 ， 用 灰色 表示 小 棋盘 
未 被 任何 玩家 占据 ， 并 使 用 紫色 表示 小 棋盘 被 两 个 玩家 占据 ( 即 在 小 棋盘 中 打 成 了 平手 )。 这 些 
drawable 的 定义 非常 简单 。 出 于 完整 性 考虑 ， 下 面 将 其 一 一 列 出 。 


下 面 是 蓝 色 背景 的 定义 ， 用 于 被 玩家 X 占 据 的 小 棋盘 。 












































ticTacToev2/src/main/res/drawable/tile_blue.xml 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
android:color="@color/dark border color"/> 
<solid android:color="@color/blue color"/> 
<corners android:radius="@dimen/corner_radius"/> 
</shape> 


下 面 是 红色 背景 的 定义 ， 用 于 被 玩家 0 占据 的 小 棋盘 。 








ticTacToev2/src/main/res/drawable/tile_red.xml 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
android:color="@color/dark border color"/> 
<solid android:color="@color/red color"/> 
<corners android:radius="@dimen/corner_radius"/> 
</shape> 


下 面 是 灰色 背景 的 定义 ， 用 于 未 被 任何 玩家 占据 的 小 棋盘 。 








ticTacToev2/src/main/res/drawable/tile_gray.xml 


<?xml version="1.0" encoding="utf-8"?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
android:color="@color/dark border color"/> 
<solid android:color="@color/gray color"/> 
<corners android:radius="@dimen/corner_radius"/> 
</shape> 


下 面 是 紫色 背景 的 定义 ， 用 于 被 两 个 玩家 占据 的 小 棋盘 。 




















ticTacToev2/src/main/res/drawable/tile_ purple.xml 


<?xml version="1.0" encoding="utf-8" ?> 
<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
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android:color="@color/dark border color"/> 
<solid android:color="@color/purple color"/> 
<corners android:radius="@dimen/corner_radius"/> 

















</shape> 
这 些小 棋盘 背景 都 是 边框 为 1 tp 的 圆 角 矩形 ， 但 分 别 用 不 同 的 颜色 来 填充 。 








.4 大 棋盘 
下 面 来 定义 大 棋盘 。 大 棋盘 没什么 需要 特别 指出 的 ， 它 是 由 9 个 小 棋盘 组 成 的 3x3 网 格 。 





ticTacToev2/src/main/res/layout/large_board.xml 


<GridLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
tools:context=",GameActivity"> 





<include android:id="@+id/largel" layout="@layout/small board" 
android:layout width="wrap content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="0" android:layout row="0"/> 

<include android:id="@+id/1large2" layout="@layout/small board" 
android:layout width="wrap_ content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="1" android:layout row="0"/> 

<include android:id="@+id/large3" layout="@layout/small board" 
android:layout width="wrap content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="2" android:layout row="0"/> 

<include android:id="@+id/large4" layout="@layout/small board" 
android:layout width="wrap_ content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="0" android:layout row="1"/> 

<include android:id="@+id/large5" layout="@layout/small board" 
android:layout width="wrap_ content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="1" android:layout row="1"/> 

<include android:id="@+id/large6" layout="@layout/small board" 
android:layout width="wrap content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="2" android:layout row="1"/> 

<include android:id="@+id/1large7" layout="@layout/small board" 
android:layout width="wrap_ content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="0" android:layout row="2"/> 

<include android:id="@+id/large8" layout="@layout/small board" 
android:layout width="wrap content" android:layout height="wrap_ content" 
android:layout margin="@dimen/small board margin" 
android:layout column="1" android:layout row="2"/> 

<include android:id="@+id/large9" layout="@layout/small board" 
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android: layout width="wrap_ content" android:layout height="wrap content" 
android:layout margin="@dimen/small board margin" 
android:layout column="2" android:layout row="2"/> 

</GridLayout> 


其 中 的 标签 <include> 以 前 没有 见 过 。 它 用 于 创建 一 个 由 属性 Layout 指 定 的 布局 实例 , 并 设 
置 其 他 属性 ， 再 将 视图 放 到 父 布局 的 指定 位 置 。 我 们 原本 需要 复制 并 粘贴 small board.xml 9 次 ， 
但 这 里 采取 了 偷懒 的 做 法 ， 即 遵循 DRY 原 则 。 


本 












































4.1.5 ”组 合 在 一 起 
定义 完 大 棋盘 后 ， 将 它 封装 到 片段 中 。 























ticTacToev2/src/main/res/layout/fragment_game.xml 


<RelativeLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
tools:context=",GameActivity"> 


<include 
layout="@layout/ large board" 
android:layout width="wrap_ content" 
android:layout height="wrap content"/> 


</RelativeLayout> 


再 将 片段 和 背景 图 像 封 装 到 活动 布局 中 。 




















ticTacToev2/src/main/res/layout/activity_game.xml 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
tools:context=",TicTacToeActivity"> 


<ImageView 
android: layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
android:src="@drawable/sandy beach"/> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="match parent" 
android:gravity="center" 
android:orientation="vertical"> 


<fragment 
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android:id="@+id/fragment 9ame" 

class="org.example. tictactoe.GameFragment" 

android:layout width="wrap_content" 

android:layout height="wrap_ content" 

tools:layout="@layout/fragment game"/> 
<1- -控制 片段 …… --> 


</LinearLayout> 


</FrameLayout> 


至 此 ， 布 局 就 定义 好 了 ,余下 的 工作 是 编写 引用 这 些 布 局 的 Java 代 码 。 




















4.2 ”开始 游戏 


暂时 切换 到 文件 MainFragment,java。 在 前 一 章 ， 我 们 让 About 按 钮 在 用 户 点 击 时 打开 一 个 对 
话 框 。 这 里 需要 编写 这 样 的 代码 ， 即 在 用 户 点 击 New 或 Continue 按 钮 时 启动 活动 GameActivity。 
为 此 ， 在 文件 MainFragment.java 的 方法 onCreateView() 中 的 return 语 句 前 面 添 加 如 下 代码 。 























ticTacToev2/src/main/java/org/example/tictactoe/MainFragment.java 


View newButton = rootView.findViewById(R.id.new button); 
View continueButton = rootView.findViewById(R.id.continue button); 
newButton.setOnClickListener (new View.0nCLickListener() { 

@Override 

public void onClick(View view) { 

Intent intent = new Intent(getActivity(), GameActivity.class); 
getActivity().startActivity(intent); 

} 
}); 
continueButton.setOnClickListener(new View.0nCLickListener() { 

@Override 

public void onClick(View view) { 

Intent intent = new Intent(getActivity(), GameActivity.class); 
intent.putExtra(GameActivity .KEY RESTORE, true); 
getActivity().startActivity(intent); 





} 
}); 


这 些 代码 首先 会 在 视图 层次 结构 中 找到 按钮 New 和 Continue， 然 后 设置 用 户 点 击 按钮 时 将 执 
行 的 点 击 监听 器 。 在 每 个 按钮 的 监听 器 中 ,都 新 建 并 启动 了 一 个 意图 。 注 意 到 这 里 传人 了 要 启动 
的 活动 (GameActivity ) 的 名 称 。 因 为 我 们 知道 这 个 意图 ， 因 此 无 需 查找 它 。 

意图 包含 活动 启动 时 需要 的 所 有 参数 。 开 始 新 游戏 时 ， 不 需要 任何 参数 ; 但 继续 玩 游 戏 时 ， 
需要 传递 一 个 标志 ， 指 出 应 接着 玩 游戏 。 为 此 ， 对 意图 调用 了 方法 putExtra() 来 设置 变量 
KEY_RESTORE 的 值 。GameActivity 启 动 时 将 读 取 这 个 变量 的 值 。 














4.2.1 使 用 快捷 键 Alt+Enter 
注意 到 ， 代 码 Intent 是 红色 的 ， 这 是 因为 我 们 没有 导入 这 个 类 。 在 单词 Intent 上 单 击 ， 然 后 
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按 快捷 键 AlttEnter， 将 自动 在 文件 开头 附近 添加 如 下 import 语 句 ， 而 前 述 错 误 也 将 消失 。 


ticTacToev2/src/main/java/org/example/tictactoe/MainFragment.java 
import android.content.Intent; 


通过 使 用 快捷 键 AltrEnter， 可 自动 生成 导入 类 和 方法 的 import 语 句 ， 从 而 修复 大 量 的 错误 。 








4.2.2 ”编写 GameActivity 类 
GameActivity 类 的 代码 大 致 如 下 。 


ticTacToev2/src/main/java/org/example/tictactoe/GameActivity.java 


package org.example.tictactoe; 


import android.app.Activity; 

import android.app.AlertDialog; 

import android.app.Dialog; 

import android.content.DialogInterface; 
import android.os.Bundle; 

import android.util.Log; 


public class GameActivity extends Activity { 
@Override 
protected void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity game); 
// 在 这 里 恢复 游戏 …… 
} 
} 


方法 onCreate() 在 活动 启动 时 被 调用 。 它 根 据 前 面 创建 的 XML 文 件 layout/activity_game.xml 
创建 视图 。 


说 到 XML， 每 次 在 Android 程 序 中 添加 新 活动 时 ， 都 必须 修改 AndroidManifestxml 以 引用 它 。 
为 此 ， 只 需 在 appLication 元 素 未 尾 前 面 添 加 如 下 代码 行 即 可 。 





ticTacToev2/src/main/AndroidManifest.xml 
<activity 
android:name="org.example.tictactoe.GameActivity"> 
</activity> 
属性 android:name 的 值 必须 与 Java 代 码 中 的 类 名 和 包 名 一 致 。 如 果 包 名 与 清单 文件 中 指定 
的 包 名 相同 ， 可 省 略 包 名 ， 但 不 能 省 略 类 名 前 面 的 句点 (. )。 


1. 继续 游戏 


我 们 需要 支持 继续 玩 还 没有 结束 的 游戏 。 为 此 ， 需 要 在 方法 onCreate( ) 中 添加 几 行 代码 ， 
还 需 给 GameActivity 类 声明 一 些 新 成 员 。 扩 展 后 的 GameActivity 类 的 定义 如 下 。 
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ticTacToev2/src/main/java/org/example/tictactoe/GameActivity.java 


public static final String KEY RESTORE = "key restore"; 
public static final String PREF RESTORE = "pref restore"; 
private GameFragment mGameFragment; 


Goverride 
protected void onCreate(Bundle savedInstanceState) { 
Super.onCreate(SavedInstance9tate) ; 
SetContentView(R.Layout.activity game); 
// 在 这 里 恢复 游戏 …… 
mGameFragment = (GameFragment) getFragmentManager() 
.findFragmentById(R.id.fragment game); 
boolean restore = getIntent().getBooleanExtra(KEY RESTORE, false); 
if (restore) { 
String gameData = getPreferences (MODE PRIVATE) 
.getString(PREF RESTORE, null); 
if (gameData != null) { 
mGameFragment.putState(gameData); 
} 
} 


Log.d("UT3", "restore = " + restore); 


} 


KEY_RESTORE 是 传递 给 新 活动 的 标志 的 名 称 ， 用 于 将 棋盘 恢复 到 以 前 冻结 的 状态 。 首 先 对 
Intent 实 例 调 用 方法 getBooLeanExtra() ， 以 获取 这 个 标志 的 值 。 


如 果 为 true， 就 使 用 方法 getPreferences() 获 取 指 向 该 活动 的 Android 首 选项 管理 器 的 名 
柄 ， 再 调用 方法 getString() 获 取 PREF_RESTORE 项 的 值 。 首 选项 非常 适合 用 于 永久 性 存储 少量 
的 数据 。 存 储 大 量 数据 时 ， 应 使 用 SQLite 数 据 库 ， 详 情 请 参阅 第 13 章 。 


为 了 与 活动 中 的 游戏 片段 交流 ,调用 方法 getFragmentManager() 来 获取 一 个 句柄 ， 这 个 名 
柄 指向 跟踪 所 有 片段 的 对 象 。 接 下 来 ， 调 用 方法 findFragmentById() 来 获取 指向 游戏 片段 的 引 
用 。 这 并 非 唯一 的 方式 ， 也 不 一 定 是 最 佳 的 方式 ， 但 这 种 方式 既 实 用 也 管用 。 从 首选 项 中 获取 游 
戏 的 状态 后 ， 便 可 以 调用 片段 的 方法 putState() 来 修改 游戏 的 状态 了 。 

这 样 ，GameActivity 启 动 时 ， 将 从 首选 项 中 读 取 游戏 的 状态 。 下 面 来 看 看 游戏 状态 是 如 何 保 
存 的 。 

2. 保存 游戏 

我 们 希望 的 行为 如 下 : 不 管 游戏 为 何 停止 ， 即 不 管 是 因为 用 户 切 换 到 了 主屏 幕 、 启 动 了 另 一 
个 应 用 还 是 按 了 返回 按钮 ,我们 都 希望 能 够 从 中 断 的 地 方 继续 。 为 此 , 每 当 活 动 不 再 处 于 运行 状 
态 时 (参见 图 2-4 所 示 的 生命 周期 示意 图 )， 都 需要 保存 游戏 。 

从 图 2-4 可 知 ， 在 方法 onPause() 中 执行 这 种 保存 工作 非常 合适 。 下 面 就 来 在 GameActivity 
类 中 创建 方法 onPause() ， 并 添加 保存 游戏 的 代码 ( 别 忘 了 ， 要 重新 设置 代码 的 格式 ,使 其 阅读 
起 来 更 容易 ， 可 使 用 快捷 键 Ctrl+Alt+L )。 
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ticTacToev2/src/main/java/org/example/tictactoe/GameActivity.java 


@Override 
protected void onPause() { 
super.onPause(); 
String gameData = mGameFragment .getState() ; 
getpPreferences (MODE PRIVATE).edit() 
.putString(PREF RESTORE, gameData) 
.Commit(); 
Log.d("UT3", "state = " + gameData); 
上 


首先 ， 调 用 超 类 的 方法 onPause() ， 即 Activity,.onPause()。 重 写 超 类 的 方法 时 ， 都 应 调 
用 超 类 的 相应 方法 。 对 于 与 初始 化 相关 的 所 有 onXX 方 法 ， 通常 i id 但 
对 于 在 终止 时 调用 的 方法 , 应 在 最 后 调用 超 类 的 相应 方法 。 如 果 不 确定 该 在 什么 地 方 调用 超 类 的 
相应 方法 ， 在 开头 调用 即 可 。 


接 下 来 ， 调 用 片段 的 方法 getState() 来 获取 游戏 数据 。 然 后 ， 获 取 一 个 指向 首选 项 存储 区 
的 句柄 ( getPreferences )， 为 首选 项 创建 一 个 编辑 器 (edit )， BR 
戏 数据 ( putString )， 并 将 修改 存储 到 首选 项 存储 区 ( commit )。Log.d() 负 责 将 一 条 调试 消息 
写 和 日志。 

3. 重新 开始 游戏 


有 时 候 , 我 们 可 能 想 清除 所 有 的 记录 , 一 切 从 头 开 始 。 这 正 是 方法 restartGame() 的 目的 
所 在 。 























ticTacToev2/src/main/java/org/example/tictactoe/GameActivity.java 


public void restartGame() { 
mGameFragment. restartGame(); 
} 
它 只 是 调用 稍 后 将 介绍 的 片段 类 的 同名 方法 。 
4. 宣布 获胜 方 
确定 获胜 方 后 ， 需 要 采取 某 种 方式 进行 通告 。 这 项 工作 是 由 方法 reportwinner() 完 成 的 。 








A 






































ticTacToev2/src/main/java/org/example/tictactoe/GameActivity.java 


public void reportWinner(final Tile.Owner winner) { 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
builder.setMessage(getString(R.string.declare winner, winner)); 
builder.setCancelable(false); 
builder.setPositiveButton(R.string.ok label, 
new DialogInterface.OnClickListener() { 
GOverride 
public void onClick(DialogInterface dialogInterface, int i) { 
finish(); 
} 
}); 
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final Dialog dialog = builder.create(); 
dialog.show(); 


// 将 棋盘 重 置 为 初始 状态 
mGameFragment.initGame(); 


} 


上 述 代 码 使 用 AlertDialog.Builder 类 创建 了 一 个 消息 框 , 其 中 包含 一 行文 本 和 一 个 OK 按 
钮 。 用 户 点 击 OK 按钮 时 ,活动 将 结束 ， 即 关闭 游戏 屏幕 并 返回 到 主 菜 单 。 











4.2.3 编写 GameFragment 类 


到 目前 为 止 ，GameFragment 类 是 最 复杂 的 ， 因 为 它 需要 做 的 工作 很 多 。 下 面 来 定义 这 个 类 4 
的 轮廓 ， 包 括 需 要 的 所 有 :import 语句 。 








ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 


package org.example.tictactoe; 


import android.app.Fragment; 

import android.os.Bundle; 

import android.util.Log; 

import android.view.LayoutInfLater; 
import android.view.View; 

import android.view.ViewGroup ; 
import android.widget.ImageButton; 


import java.util.HashSet; 
import java.util.Set; 


public class GameFragment extends Fragment { 
// 在 这 里 定义 数据 结构 …… 
@Override 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
// 设备 配置 发 生变 化 时 保留 这 个 片段 
setRetainInstance(true); 
initGame(); 
上 
@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View rootView = 
inflater.inflate(R.layout.large board, container, false); 
initViews (rootView); 
updateAllTiles(); 
return rootView; 


} 
这 里 有 两 个 重要 的 方法 。 方 法 onCreate () 在 创建 片段 时 被 调用 。 在 这 个 方法 中 ， 我 们 调用 
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了 方法 setRetainInstance(true)， 这 样 在 父 活 动因 设备 配置 发 生变 化 ( 如 设备 旋转 ) 而 被 销 
毁 时 ，Android 不 会 销毁 该 片段 。 接 下 来 ， 调 用 将 在 后 面 编 写 的 方法 initGame() ， 以 设置 所 有 的 
数据 结构 。 这 个 方法 将 稍 后 介绍 。 

虽然 这 个 片段 的 存活 时 间 比 包含 它 的 活动 长 ,但 它 包含 的 视图 并 非 如 此 。 方 法 onCreateView() 
用 于 创建 (或 重新 创建 ) 这 些 视图 。 它 首先 调用 方法 LayoutInflater.inflate()，, 以 读 取 定义 大 
棋盘 的 XML 并 将 其 转换 为 视图 。 接 下 来 ， 它 调用 两 个 方法 初始 化 这 些 视 图 并 更 新 格子 。 这 两 个 
方法 将 在 稍 后 定义 。 要 更 详细 地 了 解 Android 调 用 片段 方法 ( 如 onCreate() 和 onCreateView()) 
的 顺序 ， 请 参阅 图 2-4 所 示 的 生命 周期 示意 图 。 


1. 数据 结构 


在 接着 往 下 介绍 前 ， 先 在 GameFragment 类 中 定义 其 他 方法 所 需 的 一 些 数据 结构 。 这 些 数据 
结构 应 在 类 定义 的 开头 定义 。 





















































ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 

// 在 这 里 定义 数据 结构 …… 

static private int mLargeIds[] = {R.id.largel, R.id.large2, R.id.large3, 
R.id.large4, R.id.large5, R.id.large6, R.id.large7, R.id.large8, 
R.id.large9,}; 

static private int mSmallIds[] = {R.id.smalll, R.id.small2, R.id.small3, 

.id.small4, R.id.small5, R.id.small6, R.id.small7y, R.id.small8, 

.id.small9,}; 


刀 妃 


private Tile mEntireBoard = new Tile(this); 

private Tile mLargeTiles[] = new Tile[9]; 

private Tile mSmallTiles[][] = new Tile[9][9]; 
private Tile.Owner mPLayer = Tile.Owner.X; 

private Set<Tile> mAvailable = new HashSet<Tile>(); 
private int mLastLarge; 

private int mLastSmall; 


mLargeIds 和 mSmallIds 都 是 常量 数组 ,分别 用 于 将 数字 映射 到 小 棋盘 和 格子 的 资源 id。 还 
记得 吗 ，large_board.xml 和 small_ board.xml 都 定义 了 9 个 子 视图 ， 这 些 视 图 排列 成 3x3 网 格 。 在 程 
序 中 , 将 这 些 子 视图 编号 为 0~8: 在 最 上 面 的 那 行 , 子 视图 的 编号 为 0~2; 在 中 间 那 行 , 编号 为 3~5; 
在 最 下 面 那 行 ， 编 号 为 5~8。 

mEntireBoard、mLargeTiles 和 mSmallTiles 表 示 不 同 层级 的 格子 。 在 最 顶层 ， 只 有 一 个 
格子 ， 而 在 最 底层 ， 有 81 个 格子 ， 可 放 入 X 或 O。Tile 类 可 表示 任何 层级 的 棋盘 格 ， 将 在 稍 后 进 
行 定义 。 

mPlayer 存 储 玩 家 的 id， 指 出 了 接 下 来 该 谁 下 。 玩 家 XX 总 是 先 下 。 


mAvailable 是 一 个 列表 ， 包 含 给 定时 点 可 下 的 所 有 格子 。 这 个 列表 是 根据 前 一 步 棋 和 游戏 
规则 计算 得 到 的 。 
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mLastLarge 和 mLastSmall 是 最 后 一 步 棋 的 索引 。 例如 ,如 果 它 们 都 为 4, 则 表示 最 后 一 步 棋 
下 在 棋盘 的 正中 央 。 


2. 初始 化 游戏 
创建 片段 时 ,在 方法 onCreate() 中 调用 了 方法 initGame() 。 这 个 方法 将 所 有 的 数据 结构 初 
始 化 为 起 始 状态 。 


ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 
public void initGame() { 
Log.d("UT3", "init game"); 
mEntireBoard = new Tile(this); 
// 创建 所 有 的 格子 
for (int large = 0; large < 9; large++) { 
mLargeTiles[large] = new Tile(this); 
for (int small = 0; small < 9; small++) { 
mSmallTiles[largel][small] = new Tile(this); 
} 
mLargeTiles[largel].setSubTiles(mSmallTiles[large]); 
} 


mEntireBoard.setSubTiles(mLargeTiles); 


// 设置 先 下 棋子 的 玩家 可 下 的 格子 
mLastSmall = -1; 

mLastLarge = -1; 
setAvailableFromLastMove(mLastSmall); 


} 

这 个 方法 用 于 创建 一 个 表示 整个 棋盘 的 Tile 实 例 、9 个 表示 小 棋盘 的 Tile 实 例 和 81 个 表示 格 
子 的 Tile 实 例 。 接 下 来 ， 它 会 假设 出 上 一 步 棋 ， 并 计算 哪些 格子 可 下 ( 应 该 是 全 部 格子 )。 

3. 初始 化 视图 

初始 化 视图 的 代码 如 下 。 








ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 


private void initViews(View rootView) { 
mEntireBoard.setView(rootView); 
for (int large = 0; large < 9; large++) { 
View outer = rootView.findViewById(mLargeIds[largel]); 
mLargeTiles[largel].setView(outer); 


for (int small = 0; small < 9; small++) { 

ImageButton inner = (ImageButton) outer.findViewById 
(mSmallIds[small]); 

final int fLarge = large; 

final int fSmall = small; 

final Tile smallTile = mSmallTiles[large][small]; 

smallTile.setView(inner); 

inner.setOnClickListener(new View.0nCLickListener() { 

@Override 
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public void onClick(View view) { 
if (isAvailable(smallTile)) { 
makeMove(fLarge, fSmall); 
switchTurns(); 


}); 





依次 处 理 整个 棋盘 、 小 棋盘 和 格子 。 设 置 完 整个 棋盘 、 小 棋盘 和 格子 的 视图 后 , 来 设置 用 户 
点 击 格子 时 将 调用 的 点 击 处 理 程序 : 如 果 当 前 格子 可 下 ， 就 将 棋 下 在 该 格子 中 , 并 让 另 一 个 玩家 
接着 下 。 


4. 将 棋 下 到 格子 中 
为 了 将 棋 下 到 格子 中 ， 我 们 调用 方法 makeMove() ， 并 传人 相应 的 小 棋盘 索引 和 格子 索引 。 



































ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 


private void makeMove(int large, int small) { 
mLastLarge = large; 
mLastSmall = small; 
Tile smallTile = mSmallTiles[large][small]; 
Tile largeTile = mLargeTiles[largel]; 
smallTile.setOwner(mPlayer); 
setAvailableFromLastMove(small); 
Tile.Owner oldWinner = largeTile.getOwner(); 
Tile.Owner winner = largeTile.findWinner(); 
if (winner != oLdwWinner) { 
largeTile.setOwner(winner); 
} 
winner = mEntireBoard.findWinner(); 
mEntireBoard.setOwner (winner); 
updateAllTiles(); 
if (winner != TiLe.0wner.NEITHER) { 
((GameActivity)getActivity()).reportWinner(winner); 
} 
} 


这 里 做 的 主要 工作 是 , 让 当前 玩家 占据 格子 。 接 下 来 ， 需 要 确定 是 否 有 玩家 赢得 了 当前 格子 
所 属 的 小 棋盘 。 如 果 有 ， 就 设置 该 小 棋盘 的 占据 者 。 最 后 ,检查 整个 棋盘 ， 看 是 否 有 玩家 占据 了 
整个 棋盘 。 如 果 已 经 有 玩家 占据 了 整个 棋盘 ， 就 意味 着 该 玩家 获得 了 胜利 ， 需 要 调用 宣告 获胜 者 
的 方法 。 

5. 让 另 一 个 玩家 接着 下 

这 实现 起 来 很 容易 ， 只 需 切 换 变 量 mPLayer 的 值 即 可 。 
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ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 
private void switchTurns() { 
mPLayer = mPLayer == Tile.Owner.X ? Tile.Owner.0 : Tile 
.Owner.X; 


} 
如 果 当 前 玩家 为 X， 就 将 接 下 来 的 玩家 设置 为 0， 否 则 将 接 下 来 的 玩家 设置 为 X。 
6. 重新 开始 游戏 


用 户 点 击 Restart 按 钮 时 ， 监 听 器 将 调用 GameActivity 类 的 方法 restartGame() ， 而 这 个 方 
法 将 转 而 调用 游戏 片段 的 方法 restartGame() 。 








ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 


public void restartGame() { 
initGame(); 
initViews (getView()); 
updateAllTiles(); 

} 


这 个 方法 首先 初始 化 游戏 状态 ,就 像 游戏 刚 启动 时 那样 。 接 下 来 ， 它 会 初始 化 视图 ， 并 更 新 
所 有 的 格子 以 便 正确 地 绘制 它们 。 
7. 计算 可 下 棋 的 格子 


根据 终极 版 井 字 游戏 的 规则 , 一 个 玩家 下 棋 后 ,对 手 接 下 来 只 能 在 这 步 棋 所 处 的 格子 对 应 的 
小 棋盘 内 下 棋 。 例 如 ， 如 果 玩 家 1I 下 的 棋 位 于 某 个 小 棋盘 的 左上 角 , 那么 玩家 2 接 下 来 只 能 在 左上 
角 的 小 棋盘 内 下 棋 。 如 果 没 有 可 下 棋 的 格子 ( 即 指定 的 小 棋盘 已 满 )， 则 对 手 可 在 任何 地 方 下 棋 。 


使 用 多 个 方法 来 根据 前 一 步 棋 计 算 接 下 来 可 在 哪些 格子 中 下 棋 。 

























































































ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 
private void clearAvailable() { 
mAvailable. clear(); 


} 


private void addAvailable(Tile tile) { 
mAvailable.add(tile); 
} 


public boolean isAvailable(Tile tile) { 
return mAvailable.contains (tile); 


} 


private void setAvailableFromLastMove(int small) { 
clearAvailable(); 
// 让 目标 小 棋盘 中 所 有 空格 子 都 可 下 棋 
if (small != -1) { 
for (int dest = 0; dest < 9; dest++) { 
Tile tile = m9SmaLLTiLes[smaLL][dest]; 
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if (tile.getOwner() == Tile.Owner.NEITHER) 
addAvailable(tile); 

} 
} 
// 如 果 目 标 小 棋盘 没有 空格 子 ， 则 令 整 个 棋盘 的 所 有 空格 子 都 可 下 棋 
if (mAvailable.isEmpty()) { 

setAllAvailable(); 
} 

} 


private void setAllAvailable() { 
for (int large = 0; large < 9; large++) { 
for (int small = 0; small < 9; small++) { 
Tile tile = mSmallTiles[largel[small]; 
if (tile.getOwner() == Tile.Owner.NEITHER) 
addAvailable(tile); 


} 


clearAvailable() 用 于 清空 可 下 棋 格 子 列表 , 以便 能 够 在 其 中 添加 格子 ; addAvailable() 











用 于 将 一 个 格子 加 入 可 下 棋 格 子 列表 中 ; isAvailable() 用 于 判断 指定 的 格子 是 否 可 下 棋 ; 


setAvaiLabLeFromLastMove() 用 于 清空 可 下 棋 格 子 列 表 , 并 将 目标 小 棋盘 中 所 有 的 空格 子 都 标 











记 为 可 下 棋 的 。 最 后 ， 如 果 目 标 小 棋盘 中 没有 空格 子 ， 就 调 














个 棋盘 中 的 所 有 空格 子 都 标记 为 可 下 棋 的 。 
8. 处 理 状态 





用 方法 setAllAvailable()， 将 整 


为 了 将 当前 游戏 状态 保存 下 来 ,以 便 以 后 能 够 继续 游戏 , 需要 将 游戏 的 当前 状态 转换 为 序列 
化 形式 〈 一 个 字符 串 )， 以 便 将 其 存储 到 首选 项 存储 区 中 。 下 面 是 创建 这 个 字符 上 








ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 


/** 创建 包含 游戏 状态 的 字符 串 */ 

public String getState() { 
StringBuilder builder = new StringBuilder(); 
builder.append(mLastLarge); 
builder.append(','); 
builder.append(mLastSmall); 
builder.append(', '); 
for (int large = 0; large < 9; large++) { 

for (int small = 0; small < 9; small++) { 


builder.append(mSmallTiles[largel[small].getOwner().name()); 


builder.append(','); 
3 
} 
return builder.toString(); 


} 








的 代码 。 





最 重要 的 是 ,明确 每 个 格子 都 由 哪个 玩家 占据 ,但 还 必须 跟踪 上 一 步 棋 ， 因 为 接 下 来 玩家 可 











在 哪些 地 方 下 棋 就 取决 于 上 一 步 棋 。 
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创建 字符 串 并 将 其 保存 到 首选 项 存储 区 后 , 便 可 提取 该 字符 串 并 将 其 反 序列 化 为 新 的 游戏 状 
态 。 这 是 由 方法 putState() 完 成 的 。 











ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 
/** 根据 给 定 的 字符 囊 恢复 游戏 状态 */ 
public void putState(String gameData) { 
String[] fields = gameData.split(","); 
int index = 0; 
mLastLarge = Integer.parseInt(fields[index++]); 
mLastSmall = Integer.parseInt(fields[index++]); 
for (int large = 0; large < 9; large++) { 
for (int small = 0; small < 9; small++) { 
Tile.Owner owner = Tile.Owner.value0f(fields[index++]); 
mSmallTiles[largel][small].setOwner(owner); 


} 





} 
setAvailableFromLastMove(mLastSmall); 
updateAllTiles(); 

} 


这 个 方法 基本 上 与 getState() 相 反 。 这 里 要 获取 上 一 步 棋 和 每 个 格子 的 占据 者 ， 并 将 它们 
存储 到 成 员 变量 中 。 最 后 ， 重 新 计算 可 下 棋 格 子 列 表 ， 并 更 新 所 有 格子 的 drawable 状 态 。 


在 序列 化 游戏 状态 时 ， 丢 失 了 一 些 信 息 。 你 知道 都 是 哪些 信息 吗 ? 
下 面 是 更 新 drawable 状 态 的 代码 。 



































ticTacToev2/src/main/java/org/example/tictactoe/GameFragment.java 
private void updateAllTiles() { 
mEntireBoard.updateDrawableState(); 
for (int large = 0; large < 9; Large++) { 
mLargeTiles[largel] .updateDrawableState(); 
for (int small = 0; small < 9; small++) { 
mSmallTiles[largel[small].updateDrawableState(); 
} 


} 
上 述 代 码 用 于 更 新 表示 整个 棋盘 、9 个 小 棋盘 和 每 个 格子 ( 包含 X 或 0 ) 的 Tile 实 例 的 状态 。 








4.2.4 定义 TiLe 类 



































Tile 类 表示 任何 层次 的 棋盘 格子 , 它 可 以 是 可 包含 X 或 0 的 最 小 格子 、 包 含 9 个 格子 的 小 棋盘 
或 包含 9 个 小 棋盘 的 大 棋盘 。 


下 面 是 Tile 类 的 轮廓 。 

















ticTacToev2/src/main/java/org/example/tictactoe/Tile.java 


package org.example.tictactoe; 
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import android.graphics.drawable.Drawable; 
import android.view.View; 
import android.widget.ImageButton; 


public class Tile { 


public enum Owner { 
X，0 /* 字母 0 */，NEITHER，BOTH 


// 这 些 级 别 是 在 drawabLe 中 定义 的 

private static final int LEVEL X = 0; 

private static final int LEVEL 0 = 1; // Letter 0 
private static final int LEVEL BLANK = 2; 

private static final int LEVEL AVAILABLE = 3; 
private static final int LEVEL TIE = 3; 


private final GameFragment mGame; 
private Owner mOwner = Owner.NEITHER; 
private View mView; 

private Tile mSubTiles[]; 


public Tile(GameFragment game) { 
this.mGame = game; 


} 


public View getView() { 
return mView; 


} 


public void setView(View view) { 
this.mView = view; 


public Owner getOwner() { 
return mOwner; 


} 


public void setOwner(Owner owner) { 
this.mOwner = owner; 


} 

public Tile[] getSubTiles() { 
return mSubTiles; 

public void setSubTiles(Tile[] subTiles) { 
this.mSubTiles = subTiles; 


} 
Tile 对 象 包含 占据 者 和 视图 ( 图 形 表示 )， 还 可 能 包含 一 系列 子 格 子 。Tile 类 包含 构造 函数 
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Tile， 还 包括 占据 者 、 视 图 和 子 格子 的 获取 函数 和 设置 函数 。 男 外 ， 它 还 包含 管理 drawable 状 态 
的 代码 以 及 判断 谁 是 占据 者 的 代码 。 下 面 来 看 一 下 管理 drawable 状 态 的 代码 。 这 些 代码 应 放 在 
Tile 类 的 结束 大 括号 之 前 。 








ticTacToev2/src/main/java/org/example/tictactoe/Tile.java 
public void updateDrawableState() { 


if (mView == null) return; 
int level = getLevel(); 
if (mView.getBackground() != null) { 


mView.getBackground().setLevel (level); 

} 

if (mView instanceof ImageButton) { 
Drawable drawable = ((ImageButton) mView) .getDrawable(); 
drawable.setLevel (level); 





上 


private int getLeveL() { 
int level = LEVEL_BLANK; 
Switch (mOwner) { 
case X: 
level = LEVEL X; 
break; 
case 0: // 字母 0 
level = LEVEL 0; 
break ; 
case BOTH: 
level = LEVEL TIE; 
break; 
case NEITHER: 
level = mGame.isAvailable(this) ? LEVEL AVAILABLE : LEVEL BLANK; 
break; 
} 
return level; 


} 


在 4.1.1 节 中 讲 过 ,最 小 的 格子 有 4 种 等 级 ,具体 是 哪 种 等 级 取决 于 其 占据 者 : X、O、 两 者 和 
无 。 方 法 updateDrawableState() 调 用 getLevel() 来 确定 等 级 ,然后 根据 视图 的 类 型 ， 对 视图 
背景 或 drawable 调 用 方法 setLevel ()。 


接 下 来 ， 需 要 编写 确定 占据 者 的 代码 。 























ticTacToev2/src/main/java/org/exambple/tictactoe/TileJjava 
public Owner findwinner() { 
// 如 果 已 确定 占据 者 ， 就 返回 它 
if (getOwner() != Owner.NEITHER) 
return getOwner(); 


int totalX[] = new int[4]; 
int total0[] = new int[4]; 
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countCaptures(totalX, total0); 
if (totalX[3] > 0) return Owner.X; 
if (total0[3] > 0) return Owner.0; 


// 检查 是 否 打 成 了 平局 
int total = 0; 
for (int row = 0; row < 3; row++) { 
for (int col = 0; col < 3; col++) { 
Owner owner = mSubTiles[3 * row + col].getOwner(); 
if (owner != Owner.NEITHER) total++; 
} 
if (total == 9) return Owner.BOTH; 


} 


// 未 被 任何 玩家 占据 
return Owner .NEITHER; 


} 

如 果 已 经 有 占据 者 ， 就 返回 该 占据 者 ; 否则 , 计算 两 位 玩家 占据 的 格子 数 。 如 果 有 一 个 玩家 
占据 了 3 个 排 成 一 条 线 的 格子 ， 那 么 该 玩家 就 是 占据 者 ; 否则 检查 小 棋盘 的 所 有 格子 是 否 都 不 为 
空 。 如 果 是 这 样 ， 说 明 打 成 了 平局 ， 因 此 返回 BOTH; 和 否则， 说 明 未 被 任何 玩家 占据 ， 因 此 返回 
NEITHER。 



































方法 countCaptures() 的 定义 如 下 。 


ticTacToev2/src/main/java/org/example/tictactoe/Tile.java 


private void countCaptures(int totalX[], int total0[]) { 
int capturedX, captured0; 
// 检查 是 否 有 同一 个 玩家 的 3 个 棋子 排 成 了 一 行 
for (int row = 0; row < 3; row++) { 
capturedX = captured0 = 0; 
for (int col = 0; col < 3; col++) { 
Owner owner = mSubTiles[3 * row + col].getOwner(); 


if (owner == Owner.X || owner == Owner.BOTH) capturedX++; 
if (owner == Owner.0 || owner == Owner.BOTH) capturedO0++; 
} 
totalX[capturedX]++; 
totalO[captured0]++; 


} 


// 检查 是 否 有 同一 个 玩家 的 3 个 棋子 排 成 了 一 列 
for (int col = 0; col < 3; col++) { 
capturedX = captured0 = 0; 
for (int row = 0; row < 3; row++) { 
Owner owner = mSubTiles[3 * row + col].getOwner(); 


if (owner == Owner.X || owner == Owner.BOTH) capturedX++; 
if (owner == Owner.0 || owner == Owner.BOTH) capturedO0++; 
} 
totalX[capturedX]++; 
totalO[captured0]++; 


图 灵 社 区 会 员 maik000 专 享 尊重 版 权 





4.3 ”控制 游戏 63 





// 检查 是 否 有 同一 个 玩家 的 3 个 棋子 排 成 对 角 线 
capturedX = captured0 = 0; 
for (int diag = 0; diag < 3; diag++) { 
Owner owner = mSubTiles[3 * diag + diag].getOwner(); 


if (owner == Owner.X || owner == Owner.BOTH) capturedX++; 
if (owner == Owner.0 || owner == Owner.BOTH) capturedO0++; 
} 
totalX[capturedX]++; 
totalO[capturedO0]++; 


capturedX = captured0 = 0; 
for (int diag = 0; diag < 3; diag++) { 
Owner owner = mSubTiles[3 * diag + (2 - diag)].getOwner(); 





if (owner == Owner.X || owner == Owner.BOTH) capturedX++; 
if (owner == Owner.0 || owner == Owner.BOTH) capturedO0++; 
} 
totalX[capturedX]++; 
totalO[capturedO0]++; 


} 
代码 看 起 来 有 很 多 ,但 其 实 非 常 简 单 。 首 先 ， 计算 各 行 的 X 和 OO 数量， 然后 计算 各 列 的 X 和 0O 


数量 ， 最 后 计算 两 条 对 角 线 上 的 X 和 O 数 量 。 结 果 是 通过 两 个 数组 返回 的 : 表示 玩家 X 的 数组 
totalX 和 表示 玩家 O 的 数组 total0。 





























4.3 控制 游戏 


玩 这 个 游戏 时 ,用户 可 能 想 重新 开始 游戏 或 返回 到 主 菜单 。 当 然 , 用 户 可 以 按 返回 按钮 来 返 
回 主 菜单 ， 但 鉴于 有 些 人 不 知道 返回 按钮 在 哪里 ， 我 们 将 提供 一 种 返回 主 荣 单 的 途径 。 


先 来 看 包含 按钮 Restart 和 Main Menu 的 片段 。 











ticTacToev2/src/main/res/layout/fragment_control.xml 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:orientation="horizontal" 
android:padding="@dimen/control padding" 
tools:context=",GameActivity"> 


<Button 
android:id="@+id/button restart" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:elevation="@dimen/elevation low" 
android:drawableTop="@drawable/restart" 
android:text="@string/restart label"/> 


<Button 
android:id="@+id/button main" 
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android:layout width="match parent" 
android:layout height="wrap_ content" 
android:elevation="@dimen/elevation low" 
android:drawableTop="@drawable/home" 
android:text="@string/main menu_label"/> 


</LinearLayout> 


两 幅 图 像 可 放 在 任何 drawable 目 录 中 。 我 使 用 绘图 程序 绘制 了 这 两 幅 图 像 ， 将 它们 命名 为 
home.png 和 restart.png ， 并 将 其 与 GameActivity 背 景 图 像 ( sandy_beach.jpg ) 一 起 放 在 了 目录 
res/drawable-xxhdpi 中 。 在 本 书 配套 网 站 的 示例 代码 压缩 文件 中 ， 可 找到 所 有 这 些 图 像 。 


接 下 来 ， 需 要 在 GameActivity 中 包含 一 个 新 片段 。 




















ticTacToev2/src/main/res/layout/activity_ game.xml 


<!-- 控制 片段 …… --> 

<fragment 
android:id="@+id/fragment game controls" 
class="org.example.tictactoe.ControlFragment" 
android:layout width="wrap_ content" 
android:layout height="wrap content" 
tools:layout="@layout/fragment control"/> 


最 后 ， 需 要 编写 一 些 处 理 该 布局 的 Java 代 码 。 





ticTacToev2/src/main/java/org/example/tictactoe/ControlFragment.java 


package org.example.tictactoe; 


import android.app.Fragment; 

import android.os.Bundle; 

import android.view.LayoutInflater; 
import android.view.View; 

import android.view.ViewGroup; 


public class ControlFragment extends Fragment { 


@Override 
public View onCreateView(LayoutInflater inflater, ViewGroup container, 
Bundle savedInstanceState) { 
View rootView = 
inflater.inflate(R.layout.fragment control, container, false); 
View main = rootView.findViewById(R.id.button main); 
View restart = rootView.findViewById(R.id.button restart); 


main.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View view) { 

getActivity().finish(); 

} 

}); 

restart.setOnClickListener(new View.0nCLickListener() { 
@Override 
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public void onClick(View view) { 
((GameActivity) getActivity()).restartGame(); 
} 
}); 


return rootView; 
} 
通过 Main Menu 按 钮 结束 当前 活动 ， 与 按 返 回 按钮 的 效果 相同 。 


Restart 按 钮 假定 控制 片段 做 人 在 GameActivity 中 , 因此 会 将 当前 活动 转换 为 GameActivity, 并 
调用 前 面 定 义 的 重新 开始 游戏 的 方法 。 











4.4 支持 横向 模式 


本 章 使 用 了 一 些 尺 寸 和 颜色 ， 下 面 来 定义 这 些 资 源 ， 以 消除 所 有 相关 的 错误 。 首 先 来 定义 
尺寸。 


ticTacToev2/src/main/res/values/dimens.xml 


<dimen name="activity horizontal margin">8dp</dimen> 
<dimen name="activity vertical margin">8dp</dimen> 
<dimen name="tile size">30dp</dimen> 

<dimen name="tile margin">0dp</dimen> 

<dimen name="tile padding">3dp</dimen> 

<dimen name="control padding">20dp</dimen> 

<dimen name="small board padding">2dp</dimen> 
<dimen name="small board margin">2dp</dimen> 

<dimen name="elevation low">4dp</dimen> 


你 可 能 会 问 ， 如何 确定 边 距 、 格 子 大 小 和 其 他 尺寸 呢 ? 我 本 应 该 使 用 绘图 纸 进 行规 划 的 , 但 


















































实际 情况 是 , 我 只 是 在 不 断 地 调整 和 优化 ， 直 到 获得 满意 效果 为 止 。 不 要 把 什么 事情 都 搞 得 那么 
复杂 。 
接 下 来 定义 颜色 。 


ticTacToev2/src/main/res/values/colors.xml 


<color name="dark border color">#4f4f4f</color> 
<color name="available color">#7fbf7/f</color> 
<color name="blue color">#7f7fff</color> 
<color name="gray color">#bfbfbf</color> 

<color name="purple color">#7f007f</color> 
<color name="red color">#ff7f7f</color> 


在 选择 各 种 颜色 时 ， 只 要 它们 与 背景 图 像 以 及 X 和 0 的 颜色 相配 即 可 。 
最 后 ， 别 忘 了 字符 串 。 
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ticTacToev2/src/main/res/values/strings.xml 


<string name="restart label">Restart</string> 
<string name="main menu_ label">Main Menu</string> 
<string name="declare winner">%]1$s is the winner</string> 


既然 在 定义 资源 ， 就 顺便 定义 GameActivity 和 控制 片段 的 横向 版 本 吧 ， 它 们 将 在 用 户 改变 设 
备 朝 向 时 使 用 。 横 向 版 本 与 纵向 版 本 类 似 ， 但 前 者 经 过 了 重新 排列 ， 以 使 其 更 适合 宽屏 幕 。 

















ticTacToev2/src/main/res/layout-land/activity_game.xml 


<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
tools:context=",TicTacToeActivity"> 


<ImageView 
android:layout width="match parent" 
android:layout height="match parent" 
android:scaleType="centerCrop" 
android:src="@drawable/sandy beach"/> 


<LinearLayout 
android:layout width="match parent" 
android:layout height="match parent" 
android:gravity="center" 
android:baselineAligned="false" 
android:orientation="horizontal"> 


<fragment 
android:id="@+id/fragment game" 
class="org.example. tictactoe.GameFragment" 
android:layout width="wrap_ content" 
android:layout height="wrap_ content" 
tools:layout="@layout/fragment game"/> 


<fragment 
android:id="@+id/fragment game controls" 
class="org.example. tictactoe.ControlFragment" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
tools:layout="@layout/fragment control"/> 
</LinearLayout> 


</FrameLayout> 


ticTacToev2/src/main/res/layout-land/fragment_control.xml 


<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="wrap_ content" 
android:layout height="wrap_ content" 
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android:orientation="vertical" 
android:padding="@dimen/control padding" 
tools:context=".GameActivity"> 


<Button 
android:id="@+id/button restart" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:drawableTop="@drawable/restart" 
android:elevation="@dimen/elevation_ low" 
android:text="@string/restart label"/> 


<Button 
android:id="@+id/button main" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:drawableTop="@drawab le/home" 
android:elevation="@dimen/elevation low" 
android:text="@string/main menu_label"/> 





</LinearLayout> 

请 注意 ， 这 些 版 本 存储 在 目录 res/layout-land 中 ， 其 中 的 后 级 -land 表 示 横 向 模式 。 

现在 ， 应 该 能 够 运行 这 个 游戏 了 ， 同 时 还 能 实现 轮流 下 棋 ， 直 到 一 方 获胜 。 请 找 个 朋友 一 起 
试 一 试 。 你 将 发 现 想 要 获胜 并 没有 你 想象 的 那么 容易 。 

如 果 遇 到 了 麻烦 ， 那 就 当 作 一 次 学 习 经 验 吧 。 首 先 消 除 所 有 的 编译 器 错误 ， 然 后 参考 3.6 节 
来 消除 运行 阶段 错误 ， 如 异常 和 空 屏 幕 。 

如 果实 在 不 行 ， 可 从 本 书 配 套 网 站 下 载 代码 ， 并 将 其 与 你 的 代码 进行 比较 。 为 此 ， 先 下 载 并 
解压 缩 ZIP 文 件 ， 再 在 项 目 窗口 中 右 击 文件 夹 app， 并 选择 Compare Directory with...， 然 后 切换 到 
示例 ticTacToev2 的 目录 src， 并 单 击 OK 按钮 。 




















4.5 快速 阅读 指南 
在 本 章 中 ， 你 学 习 了 如 何 从 零 开 始 创建 用 户 界面 : 从 最 小 的 单元 (格子 ) 着 手 , 依次 向 上 创 
建 小 棋盘 和 大 棋盘 。 在 布局 中 还 包含 了 其 他 布局 ， 需 要 通过 定义 样式 来 避免 自我 重复 。 你 还 学 习 
了 一 种 在 片段 和 活动 之 间 通 信 的 方式 。 
下 一 章 将 给 这 款 游戏 添加 AI, 让 它 成 为 非常 厉害 的 对 手 。 如 果 你 想 跳 过 这 部 分 , 可 以 从 配套 
网 站 下 载 相关 的 代码 ， 然 后 直接 阅读 介绍 多 媒体 的 第 6 章 以 及 介绍 动画 的 第 7 章 。 
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到 目前 为 止 ， 我 们 创建 的 游戏 的 玩法 是 ， 玩 家 X 和 O 通 过 触摸 屏幕 交替 地 下 棋 。 在 本 章 中 ， 
我 们 将 把 它 变 成 单 玩家 游戏 ， 由 玩家 和 计算 机 对 玩 。 

为 此 ， 需 要 让 这 个 应 用 知道 如 何 评估 当前 棋局 ， 并 从 所 有 的 下 法 中 选择 最 佳 的 下 法 。 因 此 ， 
我 们 需要 暂时 离开 正题 ， 来 简单 地 认识 一 人 AI ( 人 工 智能 )。 














5.1 AlI 简介 


在 你 所 想 编写 的 任何 游戏 中 ,AI 都 扮演 着 至 关 重 要 的 角色 , 在 有 些 非 游戏 程序 中 亦 如 此 。 例 
如 ，AI 被 用 于 创建 智能 应 用 , 它们 能 够 根据 以 往 的 经 验 预 测 用 户 的 行为 。 由 于 用 户 的 能 力 常 常 被 
投射 到 程序 中 ， 因 此 实现 这 样 的 人 工 智能 并 不 是 很 难 。 


5.1.1 AlI 的 工作 原理 


过 去 几 年 , 计算 机 科学 家 开发 了 很 多 教 计算 机 如 何 玩 游戏 的 方法 , 其 中 一 种 最 简单 的 方法 是 
minimax 算 法 。 这 个 算法 因 其 根据 接 下 来 轮 到 谁 下 交 蔡 地 最 小 化 或 最 大 化 得 分 而 得 名 。 


玩 游戏 的 过 程 被 分 成 一 系列 的 步 ( 半 轮 ) 玩家 下 棋 时 ,是 一 步 ; 计算 机 下 棋 时 ， 是 男 一 步 。 


轮 到 计算 机 下 棋 时 ， 将 调用 minimax 算 法 。 它 会 对 每 种 走 法 进行 评估 ( 这 是 通过 给 相应 的 棋 
局 分 配 一 个 数字 实现 的 )。 这 是 第 一 阶段 。 对 于 有 利于 玩家 的 棋局 ， 将 随意 分 配 一 个 正 数 ; 而 对 
于 有 利于 计算 机 的 棋局 ， 将 分 配 一 个 负数 。 因 此 ， 最 佳 的 走 法 就 是 数字 最 小 的 走 法 。 

接 下 来 , 对 于 每 种 走 法 , 计算 机 都 将 考虑 玩家 的 所 有 应 对 走 法 ,并 对 这 些 走 法 形成 的 棋局 进 
行 评 佑 。 这 是 第 二 阶段 。 玩 家 自然 想 选择 最 佳 的 走 法 ， 因 此 在 第 二 个 阶段 ， 最 佳 的 走 法 是 数字 最 
大 的 走 法 。 

这 个 算法 将 不 断 地 运行 。 可 以 想见 ， 它 不 能 看 很 多 步 ， 因 为 每 多 看 一 步 ， 需 要 评估 的 棋局 数 
量 就 会 有 所 增加 ,增加 的 倍数 为 这 一 步 的 可 能 走 法 数 。 例 如 ， 如 果 要 看 3 步 ， 而 每 步 都 有 5 种 可 能 
的 走 法 ， 就 需要 评估 5 x 5 x 5 = 125 个 棋局 。 如 果 试 图 看 14 步 (7 轮 )， 需 要 评估 的 棋局 数 将 多 达 
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数 10 亿 。 通 常 来 讲 ， 可 供 计 算 机 思考 的 时 间 是 有 限 的 ， 因 此 只 能 考虑 一 定 的 步 数 ,并 从 中 选择 最 
佳 的 结果 。 

为 减少 计算 量 ， 可 使 用 剪 枝 算法 (alpha-beta pruning ) "和 Negamax2 等 算法 ， 但 这 些 算 法 不 
在 本 书 的 讨论 范围 内 。 实 际 上 ， 在 这 个 示例 中 ， 我 们 只 评估 一 步 。 











5.1.2 ”形势 判断 


人 类 通过 观看 棋盘 就 能 做 出 形势 判断 , 但 计算 机 没有 这 样 的 能 力 ， 它们 只 能 理解 数字 。 如 何 
将 棋局 转换 为 数字 呢 ?” 这 是 评估 函数 的 工作 。 给 游戏 添加 AI 时 ， 创 建 良好 的 评估 函数 至 关 重要 。 
请 看 下 面 的 评估 函数 。 


ticTacToev3/src/main/java/org/example/tictactoe/Tile.java 


public int evaluate() { 
switch (getOwner()) { 
case X: 
return 100; 
case 0: 
return -100; 
case NEITHER: 
int total = 0; 
if (getSubTiles() != null) { 
for (int tile = 0; tile < 9; tiLe++) { 
total += getSubTiles()[tile].evaluate(); 
} 
int totalX[] = new int[4]; 
int total0[] = new int[4]; 
countCaptures(totalX, total0); 
total = total * 100 + totalX[1] + 2 * totalX[2] + 8 +* 
totalX[3] - total0[1] - 2 * total0[2] - 8 * total0[3]; 





} 


return total; 


} 


return 0; 


} 

终极 版 井 字 游 戏 的 棋盘 是 一 个 层次 结构 。 最 顶层 是 整个 棋盘 ， 包 含 9 个 小 棋盘 ， 而 每 个 小 棋 
盘 又 包含 9 个 格子 。 格 子 没有 子 元素 ， 它 包含 X 或 O。 

如 果 整 个 棋盘 、 小 棋盘 或 格子 被 X 或 O 玩 家 占据 ， 上 述评 佑 函数 将 返回 一 个 很 大 的 数字 。 有 
趣 的 是 未 被 任何 玩家 占据 的 情况 。 在 这 种 情况 下 ， 将 查看 下 一 层 。 

首先 评估 每 个 子 元 素 ， 并 将 每 个 子 元 素 的 评估 结果 相 加 。 接 下 来 考虑 子 元 素 的 占据 情况 ,并 
据 此 计算 一 个 公式 的 值 : 对 于 X 占 据 的 子 元 素 ， 每 出 现 3 个 排 成 一 条 线 的 情况 时 都 加 8; 每 出 现 两 
























































QD http://en.wikipedia.org/wiki/Alpha-beta_pruning 
© http://en.wikipedia.org/wiki/Negamax 
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个 子 元 素 排除 一 条 线 时 都 加 2; 每 个 单独 的 子 元 素 都 加 1; 对 于 O 占 据 的 子 元素 , 采用 相同 的 算法 ， 
但 不 是 加 上 而 是 减 去 相应 的 数字 。 


上 述评 佑 函数 使 用 的 公式 和 数字 完全 是 随意 选择 的 。 作 为 练习 , 你 能 设计 出 更 好 的 评估 函数 
吗 ? 这 应 该 不 会 太 难 。 























5.2 ”模拟 思考 过 程 


在 实际 游戏 中 , 需要 看 很 多 步 ， 直 到 游戏 结束 ( 输 、 赢 或 平 ) 或 定时 器 到 期 。 在 这 个 示例 中 ， 
我 们 将 使 用 定时 器 来 模拟 一 秒 钟 的 考虑 时 间 。 








5.2.1 使 用 HandLer 和 postDeLayed 


首先 ， 需 要 在 GameFragment.java 中 声明 并 初始 化 一 个 Android HandLer 实 例 。 





ticTacToev3/src/main/java/org/example/tictactoe/GameFragment.java 
import android.os.Handler; 
public class GameFragment extends Fragment { 

// 在 这 里 定义 数据 结构 …… 

private Handler mHandler = new Handler(); 

PO 








Handler 类 能 够 将 事情 推迟 到 以 后 再 做 。 我 们 将 调用 它 的 方法 postDelayed()， 并 传人 定时 
器 到 期 后 要 运行 的 代码 以 及 要 等 待 的 毫秒 数 。 最 重要 的 是 , 这 些 代码 将 在 用 户 界面 线程 ( 主线 程 ) 
中 执行 ， 因 此 可 以 操作 屏幕 上 的 视图 。 


为 此 ， 首 先 修改 点 击 监听 器 ， 在 其 中 调用 新 方法 think() 。 

















ticTacToev3/src/main/java/org/example/tictactoe/GameFragment.java 
private void initViews(View rootView) { 


inner.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View view) { 
if (isAvailable(smallTile)) { 
makeMove(fLarge, fSmall); 


think(); 
} 
} 
}); 
A ee 
} 
方法 think( ) 的 定义 如 下 。 


图 灵 社 区 会 员 maik000 专 享 尊重 版 权 





S$.2 ”模拟 思考 过 程 71 





ticTacToev3/src/main/java/org/example/tictactoe/GameFragment.java 


private void think() { 
((GameActivity)getActivity()).startThinking(); 
mHandler.postDelayed(new Runnable() { 
@Override 
public void run() { 
if (getActivity() == null) return; 
if (mEntireBoard.getOwner() == Tile.Owner.NEITHER) { 
int move[] = new int[2]; 
pickMove (move); 


if (move[0] != -1 && move[1] != -1) { 
SwitchTurns () ; 
makeMove (move[0], move[1]); 
switchTurns(); 

} 


} 
((GameActivity) getActivity()).stopThinking(); 


} 
}, 1000); 
} 


用 户 轻 按 棋盘 格 时 , 开启 思考 指示 器 ,执行 用 户 要 求 下 的 棋 , 然后 启动 定时 器 。1000 毫 秒 (1 
秒 ) 后 ， 执 行 方法 run()。 

如 果 等 待 期 间 活 动 未 关闭 且 游 戏 未 结束 ， 就 来 执行 下 一 步 棋 ， 然 后 关闭 思考 指示 需 。 仅 此 而 
已 ! 准确 地 说 ， 是 差不多 仅 此 而 已 。 





























5.2.2 ”在 思考 期 间 阻 断 输 入 


刚 编 写 出 来 时 ， 程 序 最 初 运行 得 很 好 ,但 如 果 轻 按 棋盘 格 的 速度 太 快 ,程序 就 月 省 了 。 这 是 
因为 , 我 在 思考 期 间 轻 按 了 棋盘 格 和 按钮 ， 导致 代码 没有 按 正确 的 顺序 执行 。 如何 避免 这 种 情况 
的 发 生 呢 ? 


一 种 办 法 是 , 在 每 个 接受 输入 的 地 方 都 进行 检查 。 如 果 当 前 为 思考 时 间 ， 就 禁止 轻 按 操作 进 
入 队列 。 还 有 一 种 更 简单 的 方法 , 那 就 是 在 思考 期 间 阻 断 所 有 的 和 输入。 可 以 巧妙 地 利用 思考 指示 
需 来 达到 这 个 目的 。 并 不 是 要 将 指示 需 设 计 得 很 小 ,只 占据 一 角 ， 而 是 要 将 其 设计 为 覆盖 整个 屏 
幕 的 大 视图 ， 从 而 拦截 所 有 的 轻 按 操作 。 可 以 在 该 视图 的 一 角 放 置 进度 指示 器 ， 其 他 部 分 均 设置 
为 透明 的 。 图 5-1 是 我 们 希望 游戏 陷入 思考 时 用 户 看 到 的 界面 。 


该 思考 视图 的 布局 如 下 。 





































































































ticTacToev3/src/main/res/layout/thinking.xml 

<?xml version="1.0" encoding="utf-8"?> 

<FrameLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/thinking" 


图 灵 社 区 会 员 maik000 专 享 尊重 版 权 








7 第 $ 章 ”机 器 幽灵 





android:layout width="match parent" 
android:layout height="match parent" 
android:clickable="true" 
android:visibility="gone" 
tools:showIn="@layout/game activity"> 


<ProgressBar 

android:background="@drawable/thinking background" 
android:elevation="@dimen/elevation high" 
android:layout marginTop="@dimen/activity vertical margin" 
android:layout marginLeft="@dimen/activity vertical margin" 
android:layout width="@dimen/thinking progress size" 
android:layout height="@dimen/thinking progress size" 
android:indeterminate="true"/> 

</FrameLayout> 





图 5-1 





在 GameActivity 的 布局 中 ， 在 FrameLayout 结 束 标签 前 面 添加 下 面 一 行 。 


ticTacToev3/src/main/res/layout/activity_game.xml 
<include layout="@layout/thinking"/> 


进度 条 的 背景 是 一 个 椭圆 。 


























ticTacToev3/src/main/res/drawable/thinking_background.xml 

<?xml version="1.0" encoding="utf-8"?> 

<shape 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="oval"> 


<solid android:color="@color/thinking background color"/> 
</shape> 


现在 ， 可 以 在 GameActivity 中 使 用 这 个 视图 了 。 
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ticTacToev3/src/main/java/org/example/tictactoe/GameActivity.java 


import android.view.View; 


public class GameActivity extends Activity { 
// AT 
public void startThinking() { 
View thinkView = findViewById(R.id.thinking); 
thinkView.setVisibility(View.VISIBLE); 
} 


public void stopThinking() { 
View thinkView = findViewById(R.id.thinking); 
thinkView.setVisibility(View.GONE); 


} 

这 里 有 两 个 方法 : startThinking() 和 stopThinking() ， 它 们 都 可 以 获取 我 们 在 
activity_game.xml 中 添加 的 思考 视图 ， 然 后 将 它 设置 为 可 见 或 消失 ( Gone )。 消 失 类 似 于 不 可 见 ， 
但 不 接受 任何 事件 ， 也 不 加 入 到 布局 中 。 





























5.3 下 棋 


要 选择 接 下 来 的 走 法 ,只 需 评估 每 种 可 能 走 法 导致 的 棋局 ,并 选择 得 分 最 低 的 走 法 即 可 ( 别 
忘 了 ， 在 计算 机 看 来 ， 低 就 是 好 )。 























5.3.1 选择 正确 的 走 法 
在 GameFragmentjava 中 ， 添 加 下 述 选择 走 法 的 代码 。 


ticTacToev3/src/main/java/org/example/tictactoe/GameFragment.java 


private void pickMove(int move[]) { 
Tile.Owner opponent = mPLayer == Tile.Owner.X ? Tile.Owner.0 : Tile 
.Owner.X; 
int bestLarge = -1; 
int bestSmall -1; 
int bestValue = Integer.MAX VALUE; 
for (int large = 0; large < 9; large++) { 
for (int small = 0; small < 9; small++) { 
Tile smallTile = mSmallTiles[large][small]; 
if (isAvailable(smallTile)) { 
// 尝试 下 棋 并 评估 得 到 的 棋局 的 得 分 
Tile newBoard = mEntireBoard.deepCopy(); 
newBoard.getSubTiles()[large] .getSubTiles()[small] 
.SetOwner(opponent ) ; 
int value = newBoard.evaLuate( ) ; 
Log.d("UT3", 
"Moving to "+ large + ", " + small + " gives value "+ 
"" + value 


图 灵 社 区 会 员 maik000 专 享 尊重 版 权 





74 第 $ 章 ”机 器 幽灵 





); 
if (value < bestValue) { 
bestLarge = large; 
bestSmall = small; 


bestValue value; 
} 
} 
} 

} 

move[0] = bestLarge; 

move[1] = bestSmall; 

Log.d("UT3", "Best move is " + bestLarge + ", " + bestSmall); 


} 

遍历 每 个 棋盘 格 ( 总 共 81 个 )， 并 使 用 方法 isAvailable() 判 断 是 否 可 在 该 棋盘 格 中 下 棋 。 
如 果 可 以 ,就 复制 整个 棋盘 ， 调 用 方法 setOwner( ) 在 该 棋盘 格 中 下 棋 ， 然 后 再 评估 棋局 。 在 遍 
历 过 程 中 , 需要 记录 评估 函数 返回 的 最 佳 值 及 对 应 的 走 法 。 循环 结束 后 , 通过 传 入 的 数组 返回 走 
法 (这 是 一 个 返回 多 个 值 的 Java 成 例 )。 


下 面 是 复制 棋盘 的 代码 ， 它 包含 在 Tile.java 中 。 






















































































ticTacToev3/src/main/java/org/example/tictactoe/Tile.java 
public Tile deepCopy() { 
Tile tile = new Tile(mGame); 
tile.setOwner(getOwner()); 
if (getSubTiles() != null) { 
Tile newTiles[] = new Tile[9]; 
Tile oldTiles[] = getSubTiles(); 
for (int child = 0; child < 9; child++) { 
newTiles[child] = oldTiles[child].deepCopy(); 
4 
tile.setSubTiles (newTiles); 
} 
return tile; 


} 


首先 创建 一 个 新 的 Tile 实 例 ， 并 复制 占据 者 。 接 下 来 ,检查 它 是 否 有 子 元 素 。 如 果 有 ， 就 创 
建 一 个 新 的 Tite 引 用 数组 ， 用 来 存储 子 元 素 副本 。 人 然后， 对 每 个 子 元 素 递归 调用 deepCopy()。 
最 后 , 将 子 元 素 引 用 设置 为 这 个 新 数组 。 如 果 最 初 的 Tile 实 例 没 有 子 元 素 ( 换 名 话说, 它 是 包含 
X 或 0 的 棋盘 格 )， 那 就 什么 都 不 做 。 






































5.3.2 ”颜色 和 尺寸 


如 果 回 过 头 去 看 看 前 面 的 示例 代码 , 将 发 现 其 中 包含 颜色 和 尺寸 3 引用。 下面 是 我 给 它们 指定 
的 值 ， 你 也 可 以 使 用 你 认为 合适 的 任何 值 。 


思考 指示 需 的 背景 为 浅 灰 色 。 
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ticTacToev3/src/main/res/values/colors.xml 


<color name="thinking background color">#cfdfdfdf</color> 
指示 器 的 尺寸 是 在 res/values/dimens.xml 中 设置 的 。 


ticTacToev3/src/main/res/values/dimens.xml 


<dimen name="thinking progress size">50dp</dimen> 


指示 器 本 身 大 小 适中 ， 它 位 于 屏幕 一 角 ， 既 没有 大 到 分 散 用 户 注意 力 的 程度 ， 又 不 会 太 小 ， 
在 大 多 数 设 备 上 都 能 看 得 到 。 








5.4 快速 阅读 指南 




















在 本 章 中 , 我 们 给 游戏 添加 了 下 棋 的 功能 。 这 里 稍微 谈 及 了 博弈 论 ， 并 制作 了 一 个 在 游戏 思 





考 期 间 显 示 的 指示 器。 接 下 来 的 两 章 将 给 这 个 井 字 游 戏 添加 动画 和 声音 ， 如 果 你 对 此 不 感 兴 
可 直接 跳 到 第 8 章 ， 学 习 如 何 使 应 用 能 够 在 任何 设备 上 运行 。 
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添加 声音 








还 记得 苹果 的 电视 广告 吗 ” 一 个 剪影 跟随 着 iPod 播放 的 音乐 节奏 狂 舞 。 你 一 定 希望 自己 的 作 
品 也 像 这 样 激动 人 心 。 当 然 ， 超 过 18 岁 的 常人 无 法 这 样 跳舞 ,除非 有 人 将 一 条 几 蝎 放 进 他 的 衣服 
里 一 不 好 意思 ， 我 有 点 离 题 了 。 相 比 于 仅 使 用 文本 和 图 形 ， 添 加 音乐 和 音效 后 ,程序 更 能 让 人 
沉醉 其 中 ， 不 能 自拔 。 

本 章 介绍 如 何在 Android 应 用 中 添加 多 媒体 。 这 也 许 不 能 让 用 户 乐 不 可 支 ， 但 只 要 处 理 妥 当 ， 
至 少 能 够 让 他 们 面 圳 笑容 。 




















6.1 音乐 之 声 


那 是 一 个 狂风 大 作 的 漆黑 夜晚 …… 发 令 枪 响起 ， 他 们 起 跑 了 …… 离 比赛 结束 还 有 一 秒 钟 ， 斯 
泰 特 投 进 了 一 个 三 分 球 ， 人 群 沸腾 了 …… 


音乐 会 弥漫 在 整个 环境 中 ,影响 人 的 情绪 。 声 音 是 向 用 户 传递 信息 的 男 一 种 方式 。 你 可 以 在 
屏幕 上 显示 图 形 来 向 用 户 传递 信息 ， 并 将 音频 作为 强化 信息 传递 的 辅助 手段 。 


Android 支 持 音乐 播放 ， 这 是 通过 android.media 包 ?中 的 MediaPLayer 类 实现 的 。 下 面 来 给 井 
字 游 戏 的 开始 场景 添加 背景 乐 。 

为 此 ,首先 得 有 音乐 。 你 可 以 使 用 自己 喜欢 的 任何 音乐 。freesound.org ”是 一 个 极 佳 的 音频 搜 
索 网 站 ， 你 可 以 搜索 特定 的 音频 类 型 和 流派 ， 试 听 、 下 载 喜欢 的 音频 ,并 在 自己 的 应 用 中 使 用 它 
们 。 如 果 你 要 发 布 应 用 ， 务必 遵循 音频 版 权 许 可 ,将 其 用 于 商业 目 时 尤其 要 注意 。 

我 选择 了 用 户 a_guy_1 制 作 的 音频 epicbuilduploop, 将 其 用 作 开 场 乐 。 这 个 音频 最 初 的 格式 为 
MP3。Android 能 够 播放 MP3 ， 但 我 发 现 ， 需 要 循环 播放 或 剪辑 很 短 时 ， 使 用 OGG 格 式 的 效果 最 
佳 , 因为 起 点 和 终点 更 精确 。 有 鉴于 此 , 我 使 用 了 程序 Audacity” 对 这 个 示例 使 用 的 所 有 声音 进行 













































































GD http://d.android.com/guide/topics/media 
© http://www.freesound.org 
@® http://audacity.sourceforge.net 
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了 编辑 和 转换 。 在 本 书 配套 网 站 ?的 示例 代码 ticTacToev4 中 ， 可 以 找到 转换 后 的 音乐 和 音效 。 


挑选 并 转换 音乐 后 ， 将 其 放 到 目录 res/raw 中 (必要 时 创建 该 目录 )。 例 如 ， 我 将 我 选择 并 转 
换 的 音乐 命名 为 a guy_1_epicbuilduploop.ogg， 并 将 其 放 在 目录 res/raw/ 中 。 你 的 Android Studio 项 
目 应 类 似 于 图 6-1 所 示 。 








十 Android "| 四 直 | 汰 -及 





后 mipmap 
rr [raw 

a_guy_1_epicbuilduploop.ogg 
department64_draw.ogg 
erkanozan_miss.0gg 
frankum_loop001e.og9 
joanne_rewind.ogg 
notr_loser.ogg 
加 oldedgar_winner.ogg 
回 sergenious_ moveo.ogg 
BB] sergenious_ movex.ogg 

加 values 

《人 Gradle Scripts 


























图 6-1 将 音乐 和 音效 放 在 目录 raw 中 
接 下 来 ， 修 改 主 活动 ， 以 播放 和 停止 播放 音乐 。 








ticTacToev4/src/main/java/org/example/tictactoe/MainActivity.java 


import android.media.MediaPLayer; 


public class MainActivity extends Activity { 

MediaPlayer mMediaPlayer; 

jE A 

@Override 

protected void onResume() { 
super.onResume(); 
mMediaPlayer = MediaPlayer.create(this, R.raw.a guy 1 epicbuilduploop); 
mMediaPlayer.setVolume(0.5f, 0.5f); 
mMediaPlayer.setLooping(true); 
mMediaPlayer.start(); 

} 


@Override 

protected void onPause() { 
super.onPause(); 
mMediaPlayer.stop(); 
mMediaPlayer.reset(); 
mMediaPlayer.release(); 





QD http://pragprog.com/book/eband4 
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方法 onResume( ) 在 活动 可 见 时 被 调用 。 我 们 在 其 中 创建 了 一 个 多 媒体 播放 器 ， 并 传人 了 目 
录 res/raw 中 音频 文件 的 资源 id, 然后 稍微 降低 了 音量 , 将 播放 模式 设置 为 循环 播放 并 启动 播放 顺 。 
用 户 离 开 当 前 活动 (进入 下 一 个 屏幕 、 退 出 程序 或 启动 男 一 个 应 用 ) 时 ，Android 将 调用 
onPause() ， 以 停止 播放 音乐 并 释放 播放 器 分 配 的 所 有 资源 。 如 果 不 这 样 做 ， 将 导致 内 存 泄露 ， 
最 终 导 致 程序 崩溃 。 

现在 请 启动 这 个 游戏 。 在 主屏 幕 显示 期 间 ， 你 将 听 到 有 一 首 歌曲 在 播放 。 播 放 一 段 时 间 后 ， 
你 可 能 会 感到 厌烦 ， 此 时 可 按 返 回 按 钮 或 开始 新 游戏 ， 让 歌曲 不 再 播放 。 


6.2 更换 音乐 


在 游戏 期 间 播放 不 同 的 歌曲 可 以 起 到 不 错 的 调剂 作用 。 下 面 对 GameActivityjava 做 这 样 的 修 
改 : 添加 游戏 结束 时 要 播放 的 声音 。 首 先 ， 需 要 声明 一 个 多 媒体 播放 器 变量 和 一 个 后 面 要 用 到 的 


HandtLer。 





















































ticTacToev4/src/main/java/org/example/tictactoe/GameActivity.java 


import android.media.MediaPLayer; 
import android.os.HandLer; 


public class GameActivity extends Activity { 
private MediaPLayer mMediaPLayer; 
private Handler mHandler = new Handler(); 
YA 


接 下 来 ， 和 前 面 一 样 ， 在 方法 onResume( ) 和 onPause() 中 分 别 开 始 播放 和 停止 播放 音乐 。 


ticTacToev4/src/main/java/org/example/tictactoe/GameActivity.java 


@Override 
protected void onResume() { 
super.onResume(); 
mMediaPlayer = MediaPLayer.create(this，R.raw.frankum Loop001e) ; 
mMediaPlayer.setLooping(true); 
mMediaPlayer.start(); 
} 


@Override 
protected void onPause() { 
super.onPause(); 
mHandler.removeCallbacks (null); 
mMediaPlayer.stop(); 
mMediaPlayer.reset(); 
mMediaPlayer.release(); 
String gameData = mGameFragment .getState() ; 
getPreferences (MODE PRIVATE).edit() 
.putString(PREF RESTORE, gameData) 
.Commit(); 
Log.d("UT3", "state = " + gameData); 
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最 后 ， 修 改 方法 reportwWinner() ， 以 便 在 游戏 结束 时 根据 获胜 方 来 播放 相应 的 轻松 而 有 节 


奏 的 声音 。 


ticTacToev4/src/main/java/org/example/tictactoe/GameActivity.java 


public void reportWinner(final Tile.Owner winner) { 
AlertDialog.Builder builder = new AlertDialog.Builder(this); 
if (mMediaPlayer != null && mMediaplayer.isPlaying()) { 
mMediaPlayer.stop(); 
mMediaPlayer.reset(); 
mMediaPlayer.release(); 
} 
builder.setMessage(getString(R.string.declare winner, winner)); 
builder.setCancelable(false); 
builder.setPositiveButton(R.string.ok label, 
new DialogInterface.OnClickListener() { 
@Override 
public void onClick(DialogInterface dialogInterface, int i) { 
finish(); 
} 
}); 
final Dialog dialog = builder.create(); 
mHandler.postDelayed(new Runnable() { 
@Override 
public void run() { 
mMediaPlayer = MediaPlayer.create(GameActivity.this, 
winner == Tile.Owner.X ? R.raw.oldedgar winner 
: winner == Tile.Owner.0 ? R.raw.notr loser 
: R.raw.department64 draw 





); 
mMediaPlayer.start(); 
dialog.show!(); 


} 
}, 500); 


mGameFragment.initGame(); // 将 棋盘 重 置 为 初始 状态 
} 


如 果 当 前 正在 播放 音乐 ， 就 调用 方法 MediaPlayer.stop() 停 止 播放 。 接 下 来 ,设置 一 个 
HandLler， 以 便 在 半 秒 (500 毫秒 ) 后 运行 一 段 代 码 。 这 段 代 码 负责 创建 一 个 新 的 多 媒体 播放 器 ， 
并 传人 要 播放 的 声音 的 id。 为 此 ， 我 从 freesound.org 网 站 挑选 了 另外 3 个 音频 剪辑 。 




















6.3 播放 下 棋 声 


观看 电视 节目 或 电影 时 , 屏幕 上 出 现 图 像 的 同时 会 伴 有 声音 , 这 些 声 音 通常 不 是 拍摄 时 录 币 
的 ， 而 是 后 期 制作 期 间 由 拟 音 师 添 加 的 。 在 拟 音 期 间 ， 拟 音 师 添 加 滴答 声 、 呼 呼声 、 脚 步 声 、 古 
心声 、 又 隆 声 等 数 千 种 声音 。 如 果 做 得 好 ， 你 根本 感觉 不 到 拟 音 师 的 存在 。 因 此 ， 下 次 请 耐 着 性 
子 看 完 演 职 人 员 名 单 ， 在 其 中 寻找 拟 音 师 。 


























一己 
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在 这 里 ， 你 将 变 身 为 拟 音 师 ， 给 井 字 游戏 添加 音效 。 具 体 地 说 ， 我 们 要 让 这 个 游戏 在 用 户 选择 
棋盘 格 或 按 重 置 游戏 的 按钮 时 发 出 声音 。 为 了 播放 这 些 声 音 , 我 们 将 使 用 男 一 个 类 一 一 SoundPool1， 
它 更 适合 用 于 播放 简短 的 声音 剪辑 。 不 同 于 MediaPlayer，SoundPool 可 同时 播放 多 种 声音 。 它 会 
跟踪 所 有 的 声音 ， 并 将 它们 混合 在 一 起 。 

使 用 new SoundPootL() 来 创建 SoundPootL 实 例 。 从 Android 5.0 ( Lollipop ) 起 ， 可 以 使 用 
SoundPool.Builder 类 ,但 由 于 我 们 希望 这 个 应 用 能 够 在 更 早 的 Android 版 本 上 运行 ， 因 此 需要 
使 用 老 旧 的 方式 。 如 果 编 译 器 显示 了 警告 消息 ,指出 构造 函数 SoundPoo1() 已 被 气 弃 ,不 用 管 它 
就 是 了 。 不 用 担心 ， 这 个 构造 函数 现在 还 管用 。 















































ticTacToev4/src/main/java/org/example/tictactoe/GameFragment.java 


import android.media.AudioManager; 
import android.media.SoundPool; 


public class GameFragment extends Fragment { 

private int mSoundX, mSound0, mSoundMiss, mSoundRewind; 

private SoundPool mSoundPool; 

private float mVolume = 1f; 

OAM 

@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
// 在 设备 配置 发 生变 化 时 保留 这 个 片段 
setRetainInstance(true); 
initGame(); 
mSoundPool = new SoundPool(3, AudioManager.STREAM MUSIC, 0); 
mSoundX = mSoundPool.load(getActivity(), R.raw.sergenious movex, 1); 
mSound0 = mSoundPool.load(getActivity(), R.raw.sergenious moveo, 1); 
mSoundMiss = mSoundPool.load(getActivity(), R.raw.erkanozan miss, 1) 
mSoundRewind = mSoundPool.load(getActivity(), R.raw.joanne rewind, 1); 


} 
方法 SoundPoo1l ,load () 接 受 3 个 参数 ， 并 
原始 声音 文件 的 资源 id 以 及 声音 的 优先 级 。 
这 个 方法 并 不 会 播放 声 。 要 播放 声音 ， 需 要 调用 方法 SoundPool .play()。 将 棋盘 格 的 点 击 
监听 器 (点击 棋盘 格 时 将 执行 的 代码 ) 修改 成 下 面 这 样 。 





人 


返回 加 载 的 声音 的 id。 这 些 参数 分 别 是 当前 活动 、 


上 





























ticTacToev4/src/main/java/org/example/tictactoe/GameFragment.java 


private void initViews(View rootView) { 
FF Roe hd 
inner.setOnClickListener(new View.0nCLickListener() { 
@Override 
public void onClick(View view) { 
if (isAvailable(smallTile)) { 
mSoundPool .play(mSoundX, mVolume, mVolume, 1, 0, 1f); 
makeMove(fLarge, fSmall); 
think(); 
} eLse { 
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mSoundPool .play(mSoundMiss, mVolume, mVolume, 1, 0, 1f); 


switchTurns(); 
mSoundPool.play(mSound0, mVolume, mVolume, 1, 0, 1f); 
makeMove (move[0], move[1]); 
switchTurns(); 
A ire 
} 
首先 播放 X 声 音 ， 指 出 用 户 已 下 棋 。1 秒 钟 后 ,播放 O 声 音 ， 指 出 计算 机 已 下 棋 。 如 果 用 户 选 
择 的 棋盘 格 不 能 下 槛 ， 就 播放 另 一 种 声音 ， 指 出 用 户 点 击 的 棋盘 格 不 对 。 
完成 这 些 修 改 后 ， 务 必 试 玩 一 盘 ， 并 让 各 种 声音 播放 出 来 ， 以 测试 它们 。 
项 便 说 一 句 ， 方 法 SoundPootL.pLay() 功 能 众多 ， 它 接受 如 下 6 个 参数 。 
口 soundID: 函数 Load () 返 回 的 声音 id。 
口 LeftVoLume: 左 声 道 的 音量 ( 取 值 范围 为 0.0~1.0 )。 
口 rightVolume: 右 声 道 的 音量 ( 取 值 范围 为 0.0~1.0 )。 
口 priority: 流 的 优先 级 (0 表示 优先 级 最 低 )。 
口 Loop: 循环 模式 〈0 表 示 不 循环 ，-1 表 示 不 断 循环 )。 
口 rate: 播放 速度 (1.0 表示 正常 播放 速度 ， 取 值 范 围 为 0.5~2.0 )。 
请 尝试 修改 这 些 参 数 ， 以 获得 不 同 的 效果 。 



























































6.4 快速 阅读 指南 


本 章 介绍 了 如 何 使 用 Android SDK 播 放 音频 剪辑 。 我 们 并 没有 讨论 录音 ， 因 为 大 多 数 程 序 都 
不 需要 录音 ， 但 如 果 你 的 程序 属于 例外 情况 ， 请 在 在 线 文 档 " 中 查找 MediaRecorder 类 。 


第 7 章 将 结束 井 字 游戏 的 编写 工作 ， 你 将 学 习 一 些 简 单 的 动画 技巧 ,它们 可 以 让 Android 程 序 


的 娱乐 性 变 得 大 不 相同 。 如 果 你 暂时 不 需要 这 样 做 ， 可 直接 跳 到 第 8 章 ， 学 习 如 何 让 应 用 能 够 在 
各 种 设备 上 运行 。 



































人 http://d.android.com/reference/android/media/MediaRecorder.html 
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要 让 Android 应 用 更 有 趣 、 更 具 娱 乐 性 ， 有 一 种 方法 ， 那 就 是 添加 动画 。 如 果 制 作 得 有 品位 ， 
动画 可 以 让 烦闷 的 程序 变 得 激动 人 心 且 充满 活力 。 

不 要 让 元 素 突然 出 现在 屏幕 上 ， 而 要 让 它们 飞人 或 跳跃 地 进入 ; 不 要 使 用 静态 的 背景 ,而 要 
通过 移动 赋予 背景 以 生机 。 对 于 必须 有 趣 的 游戏 来 说 ， 尤 其 需要 这 样 做 。 然 而 ， 过 犹 不 及 。 使 用 
动画 是 要 改善 用 户 体验 的 ， 而 不 是 分 散 用 户 注意 力 。 

在 本 章 中 ， 将 在 井 字 棋 游戏 中 添加 两 个 动画 元 素 。 首 先 ， 将 在 主 染 单 后 面 添加 滚动 的 背景 。 
然后 ， 要 让 棋盘 格 在 用 户 触摸 时 跳跃 起 来 。 























7.1 不 断 滚动 的 画卷 
我 们 要 在 开始 屏幕 上 显示 一 幅 背 景 图 像 。 它 缓慢 地 向 屏幕 左上 和 角 深 动 。 用 户 看 不 到 任何 缝隙 ， 
动画 非常 平滑 ， 如 图 7-1 所 示 。 
OXO OXMVMOXO OY 
-x X “OXOn, XO x* O xC 
i Tic Tac Sk O pa OO 人 
Continue |X O x O 


New Game 


ox Oo: 




































图 7-1 ”如 果 你 盯 着 看 很 长 时 间 ， 它 将 看 起 来 就 像 在 不 断 移动 
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7.1.1 添加 视图 


要 实现 上 述 效 果 , 需要 创建 一 个 自 定义 视图 一 一 ScrollingView, 并 让 它 覆 盖 游 戏 选 择 菜 
后 面 的 整个 屏幕 。 编 辑 文件 res/layout/activity main.xml， 将 下 面 的 元 素 作 为 第 一 个 子 元 素 插入 到 
FrameLayout 元 素 中 。 




















ticTacToev5/src/main/res/layout/activity_main.xml 


<org.example.tictactoe.ScrollingView 
android:id="@+id/main background" 
android:layout width="match parent" 
android:layout height="match parent" 
app:scrollingDrawable="@drawable/xando background"/> 


上 述 代 码 有 两 个 很 重要 的 地 方 。 首 先 ， 它 引用 的 不 是 标准 Android 视 图 ， 而 是 
org.example.tictactoe.ScrollingView, 这 个 视图 将 稍 后 定义 。 其 次 , 它 设置 了 一 个 以 前 没 
有 涉及 过 的 属性 app:scroLLingDrawabte。 这 是 一 个 自 定义 属性 ， 指 定 了 滚动 的 图 像 。 
































7.1.2 ”定义 自 定义 属性 
E 意 ， 在 前 面 的 自 定义 属性 中 ， 包 含 前 缀 app:。 这 是 一 个 XML 命 名 空间 ， 必 须 将 其 定义 为 
FrameLayout 标 签 的 一 个 属性 。 为 此 ， 应 在 xmlns :android 的 定义 后 面 添 加 如 下 属性 。 


xmlns:app="http://schemas.android.com/apk/res-auto" 


这 个 特殊 的 命名 空间 会 告诉 Android， 对 于 任何 以 app: 打 头 的 属性 ， 都 应 在 资源 目录 中 查找 
其 定义 。 创 建文 件 res/values/attrs_scrolling view.xml， 并 在 其 中 添加 如 下 定义 。 






































ticTacToev5/src/main/res/values/attrs_scrolling_view.xml 


<resources> 
<declare-styleable name="ScrollingView"> 
<attr name="scrollingDrawable" format="color|reference" /> 
</declare-styleable> 
</resources> 


使 用 什么 样 的 文件 名 无 关 紧 要 ， 只 要 将 它 放 在 正确 的 目录 中 就 行 。 这 个 文件 指出 ， 
ScrollingView 只 有 一 个 名 为 scrollingDrawable 的 属性 ， 该 属性 的 值 可 以 是 颜色 ， 也 可 以 是 
drawable 引 用 。 
































7.1.3 ”背景 信息 





我 们 要 滚动 的 背景 是 一 个 简单 的 重复 位 图 。 
ticTacToev5/src/main/res/drawable/xando_background.xml 


<?xml version="1.0" encoding="utf-8"?> 
<bitmap xmlns:android="http://schemas.android.com/apk/res/android" 
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android:src="@drawable/xando" 
android:tileMode="repeat" /> 


它 引 用 了 目录 res/drawable-mdpi 下 的 文件 xando.png。 你 可 以 使 用 任何 图 像 ， 只 要 它 能 够 无 颖 
地 平 铺 即 可 (说 起 来 容易 做 起 来 难 )。 网 上 也 有 很 多 这 样 的 图 像 ， 但 我 是 使 用 绘图 程序 手动 创建 
了 一 个 图 像 ， 你 可 以 在 本 书 配套 网 站 ?的 ticTacToev5 示 例 中 找到 该 图 像 。 











7.1.4 创建 滚动 视图 
至 此 ， 余 下 的 全 部 工作 就 是 创建 滚动 视图 。 首 先 来 创建 这 个 类 的 轮廓 。 





ticTacToev5/src/main/java/org/example/tictactoe/ScrollingView.java 


package org.example.tictactoe; 


import android.content.Context; 

import android.content.res.TypedArray ; 
import android.graphics.Canvas; 

import android.graphics.drawable.Drawable; 
import android.util.AttributeSet; 

import android.view.View; 


光束 水 
* 这 个 自 定义 视图 负责 绘制 一 幅 不 断 滚动 的 背景 图 像 
*/ 
public class ScrollingView extends View { 
private Drawable mBackground; 
private int mScrollPos; 


} 
创建 包含 属性 的 自 定义 视图 时 ，Android 要 求 必须 添加 如 下 构造 函数 。 





ticTacToev5/src/main/java/org/example/tictactoe/ScrollingView.java 


public ScrollingView(Context context) { 
super(context); 
init(null, 0); 

} 


public ScrollingView(Context context, AttributeSet attrs) { 
super(context, attrs); 
init(attrs, 0); 

} 


public ScrollingView(Context context, AttributeSet attrs, int defStyle) { 
super(context, attrs, defStyle); 
init(attrs, defStyle); 

} 


方法 init () 用 于 获取 属性 列表 ， 并 从 中 获取 所 需 的 属性 ， 如 下 所 示 。 











GD http://pragprog.com/book/eband4 
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ticTacToev5/src/main/java/org/example/tictactoe/ScrollingView.java 


private void init(AttributeSet attrs, int defStyle) { 
// 加 载 自 定义 视图 的 属性 列表 
final TypedArray a = getContext().obtainStyledAttributes( 
attrs, R.styleable.ScrollingView, defStyle, 0); 


// 获取 背景 图 像 
if (a.hasValue(R.styleable.ScrollingView scrollingDrawable)) { 
mBackground = a.getDrawable( 
R.styleable.ScrollingView scrollingDrawable); 
mBackground. setCallback(this); 


} 
// 不 再 需要 属性 列表 
a.recycle(); 


} 
实际 工作 是 二 




















方法 onDraw() 完 成 的 。 











ticTacToev5/src/main/java/org/example/tictactoe/ScrollingView.java 


GOverride 
protected void onDraw(Canvas canvas) { 
super.onDraw(canvas); 


// 获取 视图 的 尺寸 〈 不 包括 内 边 距 ) 
int contentWidth = getWidth(); 
int contentHeight = getHeight(); 





// 绘制 背景 
if (mBackground != null) { 
// 让 背景 比 实际 需要 的 更 大 
int max = Math.max(mBackground.getIntrinsicHeight(), 
mBackground.getIntrinsicWidth()); 
mBackground.setBounds(0, 0, contentWidth * 4, contentHeight * 4); 


// 调整 图 像 的 绘制 位 置 

mScrollPos += 2; 

if (mScrollPos >= max) mScrollPos -= max; 
setTranslationX(-mScrollPos); 
setTranslationY(-mScrollPos); 


// 绘制 图 像 并 指出 下 次 刷新 时 也 应 绘制 它 
mBackground.draw(canvas ) ; 
this.invaLidate() ; 


上 


这 个 方法 的 重要 部 分 是 mBackground.draw( )， 它 负责 在 屏幕 上 绘制 由 和 0O 组 成 的 背景 。 
由 于 绘制 前 调用 了 setTranslationX() 和 setTranslationY(), 这 些 X 和 O 看 起 来 像 是 在 不 断 地 
移动 。 


onDraw() 将 被 反复 调用 ( 每 帧 一 次 )， 这 是 因为 在 最 后 调用 了 invatLidate() 。 每 次 调用 
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onDraw() 时 ， 滚 动 位 置 (mScrollPos ) 都 加 2， 这 将 导致 背景 缓慢 地 向 左上 角 移 动 。 由 于 背景 
比 屏幕 大 ， 用 户 永远 都 看 不 到 其 边缘 ， 从 而 避免 了 缝隙 的 出 现 。 





7.2 ”跳跃 的 棋盘 格 


在 游戏 屏幕 中 , 若 让 X 和 O 突 然 出 现 会 显得 不 逼真 ， 下 面 让 棋盘 格 变 得 更 有 活力 : 让 X 和 O 滴 
到 棋盘 上 ， 就 像 是 凝 胶 做 的 那样 。 


























7.2.1 动画 原则 


1981 年 , 迪斯尼 动画 师 Ollie Johnston 和 Frank Thomas 出 版 了 一 部 著名 的 著作 The llusion of Life: 
Disney Animation [JT95]， 阐 述 了 从 20 世 纪 30 年 代 起 动画 师 采用 的 动画 制作 流程 。 该 书 概 述 了 12 
条 基本 的 动画 原则 "”， 这 些 原 则 在 今天 依然 适用 。 


这 些 原则 对 所 有 动画 ( 而 不 仅仅 是 动画 片 ) 来 说 都 至 关 重 要 。 有 鉴于 此 ， 下 面 将 它们 一 一 列 
出 , 然后 演示 如 何在 Android 开 发 中 遵循 这 些 原 则 ( 有 关 这 些 原 则 的 详细 描述 , 请 参阅 在 线 资料 ): 


(1) 挤 压 与 拉 伸 ( Squash and stretch ) 

(2) 预备 动作 ( Anticipation ) 

(3) 分 镜 ( Staging ) 

(4) 逐 帧 绘制 和 使 用 关键 帧 (Straight ahead action and pose to pose ) 
(5) 随 动 和 重 双 动作 (Follow through and overlapping action ) 

































































(6) 组 入 缓 出 (Slow in and slow out ) 
(7) 弧 线 运动 (Arc ) 

(8) 次 要 动作 ( Secondary action ) 

(9) 节奏 ( Timing ) 

(10) 夸张 (Exaggeration ) 

(11) 扎实 的 绘画 功力 〈Solid drawing ) 
(12) 吸引 力 (Appeal ) 


在 Android 中 ， 动 画 是 在 XML 文 件 中 定义 的 。 请 在 res 目 录 中 新 建 一 个 名 为 animator 的 子 日 录 ， 
再 在 这 个 子 目录 中 新 建 一 个 名 为 tictactoe.xml 的 文件 ， 并 在 其 中 添加 如 下 内 容 。 

















QD http://en.wikipedia.org/wiki/12_basic_principles_of animation 
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ticTacToev5/src/main/res/animator/tictactoe.xml 
<?xml version="1.0" encoding="utf-8"?> 
<set xmlns:android="http://schemas.android.com/apk/res/android"> 
<objectAnimator 
android:duration="500" 
android:interpolator="@android:interpolator/overshoot" 
android:propertyName="scaleX" 
android:valueFrom="2" 
android:valueTo="1" /> 
<objectAnimator 
android:duration="700" 
android:interpolator="@android:interpolator/overshoot" 
android:propertyName="scaleY" 
android:valueFrom="2" 
android:valueTo="1" /> 


</set> 

这 个 文件 定义 了 一 个 动画 集 , 该 动画 集 同时 也 是 影响 对 象 多 个 属性 的 动画 。 在 这 里 , 影响 的 
属性 是 对 象 的 水 平 尺寸 ( 宽度 ) 和 垂直 尺寸 ( 高 度 )。 

对 于 这 两 个 属性 , 我 们 都 将 其 起 始 值 设置 得 很 硅 张 一 一 正常 值 的 2 倍 (原则 10 ), 然后 逐渐 将 
它们 缩小 到 正常 值 。 我 们 定义 了 起 始 帧 和 结束 帧 ， 并 让 计算 机 填充 过 渡 帧 (原则 4 )。 

动画 的 节奏 (原则 9 ) 是 由 属性 duration 设 置 的 。 注意 到 两 个 属性 的 变化 持续 时 间 稍 有 不 同 ， 
从 而 创建 了 挤 压 和 拉 伸 效果 ( 原则 1 )。 中 间 帧 是 由 属性 interpotator 控 制 的 ， 使 用 该 属性 创建 
了 随 动 ( 演 落 ) 效果 (原则 5 )。 通 过 将 interpoLator 属 性 设置 为 不 同 的 值 ， 还 可 以 创建 组 入 组 
出 效果 ( 原则 6 )、 预 备 动作 效果 ( 原则 2 ) 和 弧 线 运动 效果 ( 原则 7 )。 































































































7.2.2 走 起 


定义 通用 的 动画 后 , 需要 在 合适 的 时 候 将 其 应 用 于 棋盘 格 。 为 此 , 在 文件 GameFragment.java 
要 在 方法 addAvaitLabtLe() 开 头 调用 animate() 。 





中 


ticTacToev5/src/main/java/org/example/tictactoe/GameFragment.java 


private void addAvailable(Tile tile) { 
tile.animate(); 
mAvailable.add(tile); 

} 


这 导致 可 着 子 的 棋盘 格 将 执行 跳跃 动画 。 
接 下 来 ， 在 initViews() 内 的 方法 onClick() 开 头 ， 也 调用 animate()。 


ticTacToev5/src/main/java/org/example/tictactoe/GameFragment.java 


public void onClick(View view) { 
smallTile.animate(); 
大 人 
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这 将 导致 用 户 触摸 的 棋盘 格 跳跃 起 来 。 最 后 ， 在 方法 makeMove( ) 中 调 月 





所 示 。 


ticTacToev5/src/main/java/org/example/tictactoe/GameFragment.java 
if (winner != oLdwinner) { 

largeTile.animate(); 

largeTile.setOwner(winner); 


} 


月 animate ( ) ， 如 下 


这 将 导致 玩家 X 或 0O 廉 得 小 棋盘 ， 小 棋盘 执行 动画 。 如 果 不 知道 该 在 什么 地 方 调用 


animate() ， 请 参阅 本 书 配套 网 站 的 示例 代码 。 
下 面 来 添加 刚才 调用 的 方法 animate()。 








7.2.3 ”观看 跳跃 的 棋盘 格 





完成 所 有 的 准备 工作 后 ， 不 需要 做 太 多 的 工作 就 能 实际 执行 动画 。 为 此 ， 首 先 需要 在 文件 





Tilejava 的 开头 添加 两 条 import 语 句 。 


ticTacToev5/src/main/java/org/example/tictactoe/Tile.java 


import android.animation.Animator; 
import android.animation.AnimatorInfLater; 


然后 ， 编 写 方法 animate() ， 如 下 所 示 。 





ticTacToev5/src/main/java/org/example/tictactoe/Tile.java 
public void animate() { 
Animator anim = AnimatorInfLater.LoadAnimator(mGame.getActivity()， 
R.animator.tictactoe); 
if (getView() != null) { 
anim.setTarget (getView()); 
anim.start(); 
} 
} 


第 1 行 用 于 加 载 前 面 定义 的 动画 tictactoe.xml。 接 下 来 ， 如 果 有 视图 关联 至 
图 设置 为 动画 的 目标 ， 再 启动 动画 。 


这 就 是 运行 动画 所 需 的 全 部 代码 ! 








7.2.4 现状 














| 棋盘 格 ， 就 将 该 视 


祝贺 你 ! 下 一 章 再 做 一 些 细微 的 调整 , 整个 井 字 游 戏 示 例 就 完成 了 。 通 过 创建 这 个 示例 程序 ， 

















你 学 习 了 创建 基本 的 Android 应 用 所 需 的 全 部 知识 ， 具 体 如 下 。 
口 使 用 活动 和 片段 创建 应 用 。 
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口 使 用 XML 创建 用 户 界面 。 
口 响应 用 户 输入 。 
口 添加 声音 和 动画 。 


图 7-2 显 示 了 最 终 完成 的 作品 。 








































































Continue 


7 
) | New Game 
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图 7-2 


现在 休息 一 会 , 来 尝试 玩 玩 这 个 游戏 。 将 它 介 绍 给 你 的 朋友 ,然后 大 刀 阔 竹 地 改进 它 。 别 忘 
了 ， 这 个 游戏 以 及 本 书 所 有 示例 的 源 代码 都 可 在 配套 网 站 找到 。 





7.3 快速 阅读 指南 


在 本 章 中 给 并 字 游 戏 添加 了 两 个 动画 效果 : 主屏 幕 滚动 的 背景 以 及 游戏 屏幕 中 跳跃 的 棋盘 
格 。 你 在 这 里 学 到 的 技巧 在 很 多 情况 下 都 将 有 用 武之 地 。 

下 一 章 将 探索 如 何 让 应 用 能 够 适应 各 种 屏幕 尺寸 和 设备 。 我 们 将 妥善 地 处 理 这 个 井 字 游 戏 ， 
让 它 在 手机 和 平板 电脑 上 看 起 来 都 会 很 漂亮 ， 并 能 很 好 地 运行 。 第 9 章 将 介绍 如 何 将 应 用 发 布 到 
Google Play Store， 而 从 第 10 章 开始 ， 将 转 而 探讨 更 高 级 的 主题 ， 如 访问 Internet 以 及 使 用 基于 位 
置 的 服务 。 
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第 三 部 分 
创 运 性 心 维 
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当前 ，Android 已 经 广泛 用 于 各 种 手机 、 平 板 电 脑 、 和 手表、 电视 等 设备 ， 这 是 福 也 是 祸 。 对 
于 消费 者 来 说 ， 这 是 福音 ， 因 为 有 形状 、 尺 寸 、 价 格 各 异 的 Android 设 备 可 供 选 择 ; 但 对 于 开发 
人 员 来 说 ， 这 是 麻烦 ， 因 为 必须 支持 各 种 各 样 的 设备 。 

雪上 加 霜 的 是 ，Android 发 展 神速 ， 导 致 Android 设 备 运 行 的 版 本 各 不 相同 ,非常 分 散 。 表 8-1 
列 出 了 已 发 布 的 所 有 Android 版 本 , 其 中 带 星 号 的 版 本 已 不 再 使 用 。Android Platform Dashboard 提 
供 了 最 新 的 图 表 ， 指 出 了 运行 各 种 Android 版 本 的 设备 所 占 的 比例 。 


Build.VERSION_CODES 列 出 了 所 有 的 Android 版 本 代号 和 API 等 级 。 












































表 8-1 Android 版 本 代号 和 API 等 级 















































版 本 代号 AplI 等 级 发 布 I 间 说明 
1.0* BASE 1 2008 年 9 月 第 一 版 
1.1* BASE 1 1 2 2009 年 2 月 跑马 灯 效 果 、 短 信 附 件 
1.5* CUPCAKE 3 2009 年 5 月 小 部 件 、 虚 拟 键盘 
1.6* DONUT 4 2009 年 9 月 高 密度 屏幕 和 低 密度 屏幕 
2.0* ECLAIR 5 2009 年 11 月 Exchange 账户 
2.0.1* ECLAIR 0 1 6 2009 年 12 月 “多 点 触摸 
2.1* ECLAIR MRI1 F 2010 年 1 月 动态 壁纸 
2.2* FROYO 8 2010 年 5 月 SD 卡 
2.3* GINGERBREAD 9 2010 年 12 月 ”原生 游戏 编程 
2.3.3 GINGERBREAD MRI 10 2011 年 2 月 NFC 
3.0* HONEYCOMB 11 2011 年 2 月 片段 、 操 作 栏 、Holo 主题 
3.1* HONEYCOMB MRI1 12 2011 年 5 月 USB API、 游 戏 杆 
3:2* HONEYCOMB MR2 13 2011 年 6 月 7 英寸 屏幕 
4.0* ICE CREAM SANDWICH 14 2011 年 10 月 “Roboto、 统 一 的 手机 /平板 电脑 UI 




















GD http://d.android.com/resources/dashboard/platform-versions.html 
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( 续 ) 
版 ”本 代 号 API 等 级 发 布 时 间 说 明 
4.0.3 ICE CREAM_ SANDWICH MRI1 15 2011 年 12 月 “社交 流 API 
4.1 JELLY BEAN 16 2012 年 6 月 Project Butter 、systrace 、 可 扩展 的 通知 
4.2 JELLY BEAN MRI 17 2012 年 11 月 “多 用 户 、 无 线 显 示 技 术 
4.3 JELLY BEAN MR2 18 2013 年 7 月 OpenGL ES 3.0、SELinux 、 权 限 设置 

( restricted profiles ) 

4.4 KITKAT 19 2013 年 10 月 ”Chromium WebView、 沉 浸 模 式 
4.4W* KITKAT WATCH 20 2014 年 6 月 Android Wear 
5.0 LOLLIPOP 21 2014 年 10 月 ART、Material design、Project Volat 
5.1 LOLLIPOP MRI1 22 2015 年 3 月 多 SIM 卡 、 运 营 商 服务 











本 章 介绍 如 何在 程序 中 支持 多 种 Android 版 本 和 屏幕 分 辨 率 。 第 一 步 是 测试 。 


8.1 ”启动 模拟 器 


在 本 书 的 大 多 数 地方 , 都 会 让 你 将 应 用 的 目标 平台 设置 为 Android4.1 ( Jelly Bean ) 版 。 然而 ， 
这 个 建议 存在 一 个 小 问题 : 程序 可 能 无 法 在 旧版 本 上 运行 。 要 确定 这 一 点 , 唯一 可 靠 的 方式 是 测 
试 。 要 在 使 用 不 同 Android 版 本 和 屏幕 尺寸 的 设备 上 测试 程序 ， 最 佳 的 方式 是 使 用 模拟 器 ， 而 不 
是 购买 市 面 上 的 每 种 Android 手 机 和 平板 电脑 。 为 此 ， 你 需要 创建 多 个 虚拟 设备 ， 它 们 的 Android 
版 本 和 屏幕 太 寸 各 不 相同 。 












































8.1.1 模拟 器 反 斗 城 
除 1.3 节 创建 的 Nexus 5 AVD 外 ， 还 建议 你 创建 表 8-2 中 所 示 的 用 于 测试 的 虚拟 设备 。 








表 8-2 ”虚拟 设备 列表 








名 称 目标 平台 分 辨 率 密 度 

Nexus 4 4.1 768x1280 xhdpi ( 超 高 点 每 英寸 ) 
Nexus 5 5.1 1080x1920 xxhdpi ( 极 高 ) 

Nexus 7 4.2 1200x1920 xhdpi 

Nexus 9 4.4 2048x1536 xhdpi 





注意 ”新 的 Android 版 本 推出 后 ,务必 将 其 纳入 测试 和 矩阵。 要 确定 可 将 哪些 旧版 本 排除 在 外 ， 可 
参阅 Android Platform Dashboard。 





下 面 来 创建 运行 Android 4.2 的 Nexus 4 模拟 器 。 在 Android Studio 中 , 单 击 AVD Manager 按 钮 启 
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动 AVD Manager， 如 图 8-1 所 示 。 


'ple\tictactoe\GameActivityjava - Android Studio 1 


AVD Manager 





图 8-1 


单 击 Create Virtual Device 按 钮 ， 再 从 Phone 类 别 中 选择 Nexus 4， 然 后 单 击 Next 按 钮 ， 如 图 8-2 
所 示 。 


Select Hardware 


Choosea device definition 








Sr [DD Nexus 4 


Cat | Resolution | Densty | | 
Ee NexusS 0" 480x800 hdpi | 








一 768px 一 


| Nexus One TT hdpi 
| Size: normal 
2 Ratio: notlong 
Ni 6 ,96" 560d | 和 > 
| exus p! | 47™ fi2s0px Density:xhdpi 
| Nexus5 xxhdpi 
| exus 7 xhdpi 


Galaxy Nexus 


| 
| | Android We... 280x280 
| 
| 


| Android We.. 1.65" 320320 
New Hardware Profile | | Import Hardware Profiles 


























现在 ,选择 一 个 系统 映像 ， 如 图 8-3 所 示 。 我 们 要 让 Nexus 4 运行 Android 4.1 ( Jelly Bean )， 
此 选择 其 x86 版 (虽然 大 多 数 设备 使 用 的 都 是 ARM 处 理 器 ,但 应 始终 使 用 Intel x86 模 拟 器 ， 因 为 
其 速度 要 比 ARM 模 拟 器 快 几 倍 )。 


如 果 所 需 的 映像 还 未 下 载 ， 单 击 Download 链 接 下 载 它 。 


接 下 来 ， 单 击 Next 按 钮 ， 然 后 单 击 Finish 按 钮 。 创 建 前 面 列 出 的 其 他 模拟 器 ， 直 到 看 到 网 8-4 
所 示 的 列表 。 
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| Virtual Device Configuration 


System Image 


Select a system image 








Release Name | ry Apllevel™ | sy ABI | Target 


KitKat Download 19 armeabi-v7a Android SDK Platform 4. 








Jelly Bean Download 18 armeabi-v7a Android SDK Platform 4. 


JellyBean Download 18 x86 Android SDK Platform 4. 
Jelly Bean 17 X86 Android 4.2.2 


Jelly Bean Download armeabi-v7a Android SDK Platform 4., 曹 


API Level 


16 


Android 

4.1.2 

Android Open Source 
Jelly Bean Download ameobiv7o | Android SDK Platform4. Project 


Jelly Bean Download mips Android 421 


Jelly Bean Download mips Android 41.2 Dylan ae 


lceCreamSandwich 15 armeabi-v7a Android SDK Platform 4. x86 





lceCreamSandwich 15 X86 Android SDK Platform 4. 





| 2 
[rl Show downloadable system images [5] ?- See documentation for Android 4.1 APIs 














图 8-3 


Your Virtual Devices 
/以 Android Studio 





| Resolution |_Apl | Target | CPU/ABI | Size on Disk 





Nexus 4 API16 768 x 1280: xhdpi 16 Android41.2 x86 271 MB 





Nexus 5 API21 x86 1080 x 1920: xxhdpi 21 Google APls x86 16GB 


Nexus 7 API17 800 x 1280: xhdpi 17 Android 422 x86 


Nexus 9 API19 1536 x 2048: xhdpi 19 Android 4.4.2 





十 Create Virtual Device... 











8.1.2 ”测试 策略 


开发 时 可 使 用 Nexus 5 AVD， 并 在 发 布 应 用 前 在 其 他 AVD 中 进行 测试 。 男 外 ， 别 忘 了 在 纵向 
和 横向 模式 下 进行 测试 。 在 模拟 器 中 ， 要 在 横向 和 纵向 模式 下 切换 ， 可 按 Ctrl+F11 键 ， 也 可 (在 
NumLock 处 于 关闭 状态 时 ) 使 用 数字 小 键盘 中 的 7 或 9。 
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除非 你 的 台式 机 配置 极 高 ， 和 否则 可 能 无 法 同时 运行 这 些 AVD。 实 际 上 , 我 发 现 每 次 只 运行 一 
个 的 效果 最 佳 。 

如 果 当 前 正在 运行 Nexus 5 模拟 器 ， 请 关闭 它 ， 再 启动 模拟 器 Nexus 4: 在 AVD Manager 中 ， 
单 击 Actions 栏 中 的 播放 图 标 。 模 拟 器 显示 主屏 幕后 ， 如 果 屏 幕 被 锁定 ,将 其 解锁 。 下 面 介绍 一 些 
可 能 出 现 问题 的 情况 。 





































































































8.2 测试 程序 
现在 运行 本 书 前 面 创建 的 井 字 游戏 程序 ， 它 将 出 现在 Nexus 4 模拟 嚣 中。 遗憾 的 是 ， 它 看 起 
来 并 不 是 太 好 ， 如 图 8-$ 所 示 ( 请 不 要 太 难 过 )。 


点 击 New Game 按 钮 开始 游戏 。 一 切 看 起 来 都 不 错 ， 但 下 棋 后 ， 所 有 的 空 模 盘 格 都 变 成 了 黑 
色 的 ， 如 图 8-6 所 示 。 









































吧 








Continue 





国 国 图 | 国 国 国 国 O 国 = | 


New Game 











时 [了 TT Om 








Restart Main Menu 





图 8-5 图 8-6 
如 何 修复 这 样 的 问题 呢 ? 


一 种 技巧 是 ， 尝 试 在 越 来 越 新 的 Android 版 本 中 运行 程序 ， 直 到 找到 没有 问题 的 版 本 为 止 。 
如 果 你 这 样 做 了 ， 将 发 现在 Android 4.3 中 ,模糊 的 问题 消失 了 ， 而 在 Android 4.2 中 ， 棋 盘 格 为 黑 
色 的 问题 也 没有 了 。 然 后 ,你 就 可 以 查看 这 两 个 版 本 的 发 行 说 明 ， 看 看 它们 有 哪些 变化 。 你 甚至 
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可 以 查看 源 代码 。 然 而 ， 这 样 做 需要 很 长 的 时 间 。 

另 一 种 方法 是 , 尝试 以 不 同 的 方式 重新 实现 代码 ， 看 看 效果 是 否 更 好 。 这 种 方法 虽然 不 那么 
科学 ,但 常常 能 够 在 更 短 的 时 间 内 奏效 。 我 将 这 种 方法 称 为 Fonzie 一 一 情景 喜剧 Happy Days 中 的 
一 个 角色 。 在 这 部 情景 喜剧 中 ， 自 动 唱机 经 常 坏 。 每 到 这 个 时 候 ，Fonzie 都 会 走 过 去 踢 一 脚 或 拌 
一 拌 ， 然 后 自动 唱机 就 好 了 。 同 样 ， 你 可 对 代码 做 细微 的 修改 ， 看 看 问题 是 不 是 消失 了 。 

在 这 里 ,我 们 结合 使 用 了 这 两 种 方法 来 修复 问题 。 首 先 , 我 找 出 这 些 问题 消失 了 的 版 本 。 但 
在 发 行 说 明 中 没有 找到 明显 的 线索 ,指出 什么 变化 是 罪魁 祸首 。 因此 ,我 开始 修改 代码 。 在 做 了 
一 番 调 整 之 后 我 发 现 ， 对 于 ScrollingViewjava 中 的 如 下 代码 : 















































ticTacToev5/src/main/java/org/example/tictactoe/ScrollingView.java 
// 调整 图 像 的 绘制 位 置 

mScrollPos += 2; 

if (mScrollPos >= max) mScrollPos -= max; 
setTranslationX(-mScrollPos); 

setTranslationY(-mScrollPos); 


如 果 将 其 修改 成 下 面 这 样 : 





ticTacToev6/src/main/java/org/example/tictactoe/ScrollingView.java 
// 调整 图 像 的 绘制 位 置 

mScrollPos += 2; 

if (mScrollPos >= max) mScrollPos -= max; 
canvas.translate(-mScrollPos, -mScrollPos); 


就 可 修复 模糊 的 问题 。 接 下 来 ， 我 研究 tle_emptyxml 的 定义 。 





ticTacToev5/src/main/res/drawable/tile empty.xml 


<shape xmlns:android="http://schemas.android.com/apk/res/android" 
android:shape="rectangle"> 
<stroke 
android:width="@dimen/stroke width" 
android:color="@color/dark border color"/> 
<corners android:radius="@dimen/corner_radius"/> 
</shape> 


发 现 如 果 像 下 面 这 样 给 形状 指定 填充 色 ， 就 可 以 修复 棋盘 格 为 黑色 的 问题 。 





























ticTacToev6/src/main/res/drawable/tile empty.xml 


<solid android:color="@color/gray color"/> 


如 果 什 么 办 法 都 不 管用 


对 于 葡 手 的 问题 ， 可 进行 版 本 检查 。 例 如 ， 可 以 使 用 代码 检查 设备 运行 的 是 否 是 较 新 的 
Android 版 本 。 如 果 不 是 ， 就 完全 禁用 滚动 效果 。 
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样 做 会 缩小 目标 用 户 的 范围 。 


// 避免 运行 较 旧 版 本 不 支持 的 代码 

if (Build.VERSION.SDK INT >= Build.VERSION CODES.KITKAT) { 
// 滚动 代码 …… 

} 


你 可 以 根据 Android 版 本 使 用 不 同 的 资源 ， 这 将 在 8.3 节 中 进行 更 详细 的 讨论 。 








最 后 ， 如 果实 在 找 不 到 解决 问题 的 简单 办 法 ， 可 以 修改 应 用 针对 的 最 低 版 本 。 但 别 忘 了 ,这 














8.3 大 小 屏幕 通 吃 























为 了 让 应 用 在 尽 可 能 多 的 Android 设 备 上 看 起 来 都 是 最 漂亮 的 ， 必 须 支 持 不 同 的 屏幕 尺寸 、 
分 辩 率 和 像素 密度 。Android 会 尽力 缩放 用 户 界面 以 适应 设备 ,但 它 并 非 什 么 时 候 都 做 得 很 好 。 
要 获悉 结果 ,唯一 的 办 法 你 可 能 猜 到 了 , 那 就 是 测试 。 为 了 确保 程序 在 尺寸 最 常见 的 设备 上 能 够 











正常 运行 ， 请 使 用 8.1 节 推荐 的 模拟 器 类 型 。 





作为 测试 ， 请 尝试 在 Nexus 9 模拟 器 中 运行 并 字 游 戏 。 你 将 发 现 ， 主 活动 中 的 菜单 和 游戏 活 


























动 中 的 棋盘 都 大 小 了 。 这 是 因为 ,所 有 的 太 二 都 是 以 dp 为 单位 指定 的 ， 而 平板 电脑 的 屏幕 比 手机 





要 大 得 多 〈 即 水 平和 垂直 dp 数 更 多 )。 有 鉴于 此 ， 在 平板 电脑 上 需要 增 大 尺寸 。 





Google Wear、TV 和 Auto 


在 手机 和 平板 电脑 上 运行 的 程序 ， 也 可 以 在 手表 ( Google Wear )、 电 视 ( Google TV ) 
和 汽车 (Google Auto ) 上 和 运行。 为 此 ， 需 要 首先 在 模拟 器 中 运行 它们 ， 看 看 其 外 观 如 何 ， 然 
后 再 调整 布局 和 尺寸 。 手 表 、 电 视 和 汽车 大 多 不 支持 触摸 屏 ， 因 此 必须 对 应 用 进行 修改 ， 以 
便 能 够 使 用 其 他 输入 方法 。 


对 于 Wear 应 用 , 有 两 种 选择 : 直接 在 手表 上 运行 ; 在 手机 上 运行 , 并 在 手表 上 显示 通知 。 
有 关 Wear 应 用 的 更 详细 信息 ， 请 参阅 Google 网 站 的 培训 教程 Building Apps for Wearables!。 

对 于 TV 应 用 ， 需 要 针对 “后 仰 ”体验 进行 专门 设计 ， 因 为 屏幕 通常 离 用 户 有 几 英 尺 。 
培训 教程 Building Apps forTV“ 提 供 了 很 多 极 有 帮助 的 小 贴 士 。 

汽车 领域 为 Android 提 供 了 新 的 成 长 机 会 。 有 关 这 方面 的 更 详细 信息 ， 请 参阅 在 线 文档 
中 的 Building Apps for Auto 部 分 。 





1. http:/d.android.comytraining/building-wearables.html 
2. http://d.android.com/training/tv 
3. http://d.android.com/training/auto 
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8.3.1 指定 替代 资源 

要 针对 特定 的 Android 设 备 配置 调整 布局 或 图 像 ， 可 在 资源 名 中 使 用 后 绥 。 

例如 ， 对 于 用 于 超 高 密度 、 高 密度 和 中 密度 屏幕 的 图 像 ， 可 将 它们 分 别 放 在 目录 
res/drawable-xhdpi、res/drawable-hdpi 和 res/drawable-mdpi 中 。 在 本 书 的 所 有 示例 中 ， 对 于 将 显示 


在 主屏 幕 上 的 程序 图 标 都 做 了 这 样 的 处 理 。 对 于 独立 于 密度 ( 即 不 应 缩放 ) 的 图 形 , 将 其 放 在 目 
录 res/drawable-nodpi 中 。 


好 在 我 们 将 所 有 尺寸 都 放 在 了 一 个 地 方 一 一 目录 values 下 的 文件 dimens.xml 中 ， 因 此 只 需 创 
建 这 个 文件 的 不 同 版 本 ,并 将 其 放 在 名 称 中 包含 不 同 屏幕 尺寸 的 目录 中 即 可 。 在 项 目 窗口 中 ,这 
些 限定 符 将 出 现在 目录 名 (Project 模 式 ) 或 指示 标签 ( Android 模 式 ) 中 。 


表 8-3 按 优先 级 列 出 了 有 效 的 目录 名 限定 符 (有 关 Android 如 何 查 找 最 匹配 目录 的 详细 说 明 ， 
请 参阅 在 线 文档 ”)。 



































表 8-3 有效 的 目录 名 限定 符 
限定 符 值 
MCC 和 MNC ”移动 国家 代码 和 可 选 的 移动 网 络 代 码 。 不 推荐 使 用 这 种 限定 符 
语言 和 地 区 两 个 字母 表示 的 语言 以 及 两 个 字母 表示 的 地 区 代码 (在 前 面 加 上 小 写字 母 r)。 例 如 ， 位 、en-rUS、 























































































































es-rES 
排版 方向 应 用 的 排版 方向 ， 应 为 ldltr( 从 左 到 右 ， 默 认 设置 ) 或 ldrtl ( 从 右 到 左 ) 
最 小 宽度 可 用 屏幕 尺寸 中 较 小 的 那个 ， 如 sw320dp 、sw600dp 、sw720dp 
宽度 以 dp 为 单位 的 最 小 屏幕 宽度 ， 屏 幕 宽度 超过 指定 值 后 才 使 用 相应 的 资源 ， 如 w720dp 、w1024dp 
高 度 义 dp 为 单位 的 最 小 屏幕 高 度 ， 屏 幕 高 度 超过 指定 值 后 才 使 用 相应 的 资源 ， 如 h720dp 、h1024dp 
屏幕 尺寸 small、normal、large、xlarge 
宽屏 幕 /高 屏幕 long、notlong 
屏幕 朝向 port、land 
UI 模 式 car 、desk 、television 、appliance 、watch 
夜间 模式 night、notnight 
屏幕 像素 密度 。 ldpi、mdpi、hdpi、xhdpi、xxhdpi、xxxhdpi、nodpi、tvpi 
触摸 屏 类 型 notouch、 finger 
键盘 是 否 可 用 keysexposed 、keyshidden 、keyssoft 
键盘 类 型 nokeys、 qwerty、12key 
可 否 导航 navexposed 、navhidden 
导航 类 型 nonav、 dpad、trackball、wheel 
SKD 版 本 设备 支持 的 API 等 级 ,在 前 面 加 上 小 写字 母 v, 如 v16、v21 








QD http://d.android.com/guide/topics/resources/providing-resources.html#BestMatch 
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要 使 用 多 个 限定 符 ， 只 需 使 用 连 字 符 ( - ) 将 它们 连接 起 来 即 可 。 人 例如， 目录 
res/drawable-fr-land-hdpi 包 含 如 下 情形 下 使 用 的 图 片 : 法 文 、 横 向 模式 和 高 密度 屏幕 。 


8.3.2 ”调整 游戏 界面 的 大 小 








以 井 字 游戏 为 例 ， 来 看 看 需要 创建 哪些 文件 。 


values/dimens.xml 中 的 基本 设置 将 用 于 最 小 的 手机 。 右 击 上 日 录 res 并 选择 New> Directory， 以 
创建 其 他 4 个 目录 : values-sw360dp 、values-sw600dp 、values-sw720dp 和 values-w820dp ( 注意 到 除 
最 后 一 个 目录 外 ， 使 用 的 都 是 “最 小 宽度 ”限定 符 。 另 外 ， 最 后 一 个 目录 可 能 已 经 是 存在 的 )。 























项 目 窗口 处 于 Android 模 式 时 ， 其 中 不 会 显示 这 些 目录 ,但 当 你 在 values 目 录 下 添加 文件 时 ， 会 要 








求 你 指定 限定 符 。 将 文件 values/dimens.xml 复 制 到 这 些 目录 中 ， 并 只 重 写 要 修改 的 值 。 我 所 使 用 


的 文件 如 下 。 
values-sw360dp (手机 ): 








ticTacToev6/src/main/res/values-sw360dp/dimens.xml 


<resources> 
<dimen name="tile size">35dp</dimen> 
</resources> 

















values-sw600dp【〔 小 型 平板 电脑 ): 





ticTacToev6/src/main/res/values-sw600dp/dimens.xml 


<resources> 


<!- - 默认 屏幕 边 距 ,根据 Android Design 指 导 原 则 --> 


<dimen name="activity horizontal margin 


">16dp</dimen> 


<dimen name="activity vertical margin">16dp</dimen> 


<dimen name="tile size">50dp</dimen> 
<dimen name="tile padding">5dp</dimen> 


<dimen name="small board padding">4dp</dimen> 
<dimen name="small board margin">4dp</dimen> 


</resources> 


values-sw720dp (〈 中 型 平板 电脑 ): 




















ticTacToev6/src/main/res/values-sw720dp/dimens.xml 


<resources> 
<dimen name="tile size">70dp</dimen> 
</resources> 


values-w820dp ( 宽屏 ): 





ticTacToev6/src/main/res/values-w820dp/dimens.xml 


<resources> 


<dimen name="activity horizontal margin">64dp</dimen> 


</resources> 
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要 确定 正确 的 值 ， 需 要 做 一 些 错误 测试 。 好 在 Android Studio 提 供 了 使 这 种 工作 实施 起 来 更 
容易 的 功能 。 


8.3.3 预览 


使 用 Android Studio 的 “预览 ”( Preview ) 窗口 ， 可 同时 查看 修改 对 多 种 屏幕 尺寸 的 影响 。 
编辑 布局 文件 ( 如 res/layout/activity_game.xml ) 时 ， 将 窗口 调整 到 尽 可 能 大 ， 再 选择 XML 右边 
的 “预览 ”窗口 中 的 Configuration 图 标 。 如 果 没 有 看 到 “预览 ”窗口 ， 可 选择 菜单 View > Tool 
Windows>Preview 来 打开 它 。 选择 Preview All Screen Sizes, 以 并 排 显 示 多 种 手机 和 平板 电脑 ( 包 
括 纵向 模式 和 横向 模式 )， 如 图 8-7 所 示 。 


接 下 来 , 创建 并 编辑 dimens.xml 文 件 , 每 次 修改 后 都 切换 到 activity_game.xml 的 “预览 ”窗口 。 
不 断 地 重复 这 种 做 法 ,直到 得 到 所 有 屏幕 都 适合 的 效果 。 最 后 ,在 每 个 模拟 器 和 实际 设备 上 运行 
这 个 游戏 ， 并 对 其 进行 测试 。 请 务必 旋转 屏幕 ， 在 横向 和 纵向 模式 下 都 进行 测试 。 





























加 activity_gamexml x | Preview 将 人 
司 日 <FrameLayout [以 -| 画 Nemus4 全 @AppTheme Ticadoer 加 前 21- 
2mlns:android="http://schemas.anc 


xmlns:tools="http://schemas .andrc 
android:layout width="match parer 
android:layout height="match pare 
tools :Context=" .TicTacToeActivity 


已 <ImageView 
android:layout width=Wnatch ps 
android:layout height="match F 
android:scaleType="centerCrop" 
白 android:src="Bdrawable/sandy 上 


日 <LinearLayout 
android:layout width="match ps 
android:layout height="match 上 
android:gravity="center" 
android:orientation="vertical" 
白 <fragment 
android:id="B+id/fragment ¢ 
class="org.example. tictactc 
android:layout width="wrap_ 
andirnid: 1avnnt heinht="wrar 














Design US 








8.3.4 使 用 样式 


对 这 个 游戏 还 需 做 一 项 调整 。Android 5.0 ( Lollipop ) 引入 了 新 的 Material 主 题 ， 改 变 了 UI 元 
素 的 外 观 和 行为 。 在 Android 5 和 更 高 版 本 中 运行 时 , 要 使 用 这 种 最 新 的 外 观 , 否则 应 用 看 起 来 会 
显得 很 过 时 ,为 此 ,创建 一 个 名 为 res/values-v21 的 目录 ,并 在 其 中 添加 文件 styles.xml( 21 是 Android 
5.0 的 API 等 级 )。 





ticTacToev6/src/main/res/values-v21/styles.xml 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
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<!-- 应 用 的 基本 样式 --> 
<style name="AppTheme" 





parent="android:Theme.Material.Light.NoActionBar.Fullscreen"> 
</style> 
</resources> 


这 样 就 修改 了 应 用 样式 ， 将 主题 Material 应 








用 于 全 屏 应 用 。 要 查看 这 样 做 后 有 何 变化 ， 可 进 
人 人“ 预览” 窗口， 并 从 “配置 ”下 拉 列 表 中 选择 Preview Android Versions 。 
8.4 














快速 阅读 指南 


要 支持 运行 不 同 Android 版 本 |] 











昌 屏 幕 尺 寸 各 不 相同 的 硬件 设备 ， 这 并 不 那么 容易 。 本 章 介 绍 
了 最 常见 的 问题 和 解决 方案 ， 为 开展 上 述 工作 奠定 了 基础 。 如 果 你 要 更 深入 地 了 解 这 方面 内 容 ， 
建议 阅读 Android 网 站 卓越 的 最 佳 实践 文档 “Supporting Multiple Screens”"。 



































经 过 一 番 艰 苦 努 力 的 工作 ， 你 终于 编写 好 了 应 用 。 接 下 来 是 有 趣 的 部 分 : 让 人 使 月 
章 介 绍 如 何 将 应 用 发 布 到 Google Play Store。 








QD http://d.android.com/guide/practices/screens_support.html 
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发 布 到 Google 


PlayWsStore 


























在 本 书 前 面 ， 你 只 是 在 模拟 器 中 运行 创建 的 软件 或 将 其 下 载 到 自己 的 Android 手 机 。 你 为 下 


一 步 做 好 了 准备 吗 ? 通过 发 布 到 Google Play Store" , 你 的 应 用 可 供 
使 用 。 本 章 就 来 告诉 你 如 何 实现 这 一 目标 。 





9.1 准备 工作 





t 数 以 百 万 计 的 其 他 Android 用 户 





























当然 , 要 将 应 用 发 布 到 Play Store, 你 得 先 编写 它 。 关于 如 何 编写 应 用 请 参阅 本 书 的 其 他 部 分 。 











然而 ， 仅 编写 代码 还 不 够 ， 你 的 程序 还 应 该 质量 上 乘 ， 没 有 bug， 
面 的 一 些小 贴 士 可 助 你 一 辟 之 力 。 





这 一 条 。 





做 不 好 。 








口 确保 程序 简单 而 精致 。 让 程序 只 做 一 件 事 情 ， 并 做 好 这 件 














并 与 尽 可 能 多 的 设备 兼容 。 下 











口 向 别人 展示 前 至 少 在 一 台 实际 设 备 上 先进 行 测试 。 就 算 将 其 他 小 贴 十 都 忘 了 ， 也 别 忘 了 


hl 





了， 而 不 要 什么 都 做 ， 什 么 都 


口 选择 你 能 够 长 期 接受 的 Java 包 名 ， 如 com.yourcompany.prog-name 。 Android 将 


AndroidManifest.xml 指 定 的 包 名 用 作 应 用 的 主 标识 符 。 任 何 两 个 程序 的 包 名 都 不 能 相同 。 











将 程序 上 传 到 Play Store 后 ， 除 非 将 其 删除 ， 要 求 所 有 用 户 印 载 ， 然 后 重新 发 布 ， 和 否则 无 


法 修改 包 名 。 











口 遵循 Android 最 佳 实践 ”， 如 ， 设 计时 必须 考虑 性 能 、 响 应 











QD http://play.google.com/store 

©® http://d.android.com/guide/publishing/versioning.html 
@® http://d.android.com/guide/practices 

(@ http://d.android.com/design 
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口 在 文件 AndroidManifest xml 中 ， 给 属性 android:versionCode 和 android:versionName 
设置 有 意义 的 值 ?。 在 命名 方案 中 ， 给 未 来 的 更 新 留 出 空间 。 


速度 和 无 缝 性 。 





口 遵循 用 户 界 面 设计 指南 ”"， 如 图 标 设 计 、 菜 单 设计 、 受 善 地 使 用 “后 退 ” 按 钮 。 
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Android 程 序 员 面 临 的 最 严峻 的 挑战 之 一 是 ， 确 保 程序 与 多 种 设备 兼容 。 你 必须 面 对 的 一 个 


问题 是 ， 用 户 设 备 的 屏幕 尺寸 是 各 不 相同 的 。 有 关 这 方面 的 建议 ， 请 参阅 第 8 章 。 
第 一 印象 和 兼容 性 虽然 重要 , 但 必须 在 如 下 两 方面 取得 平衡 , 即 在 对 程序 精 雕 细 刻 使 其 至 于 


完美 的 同时 ， 确 保 能 够 按时 发 布 它 。 若 你 认为 已 准备 就 绪 ， 接 下 来 就 需要 进行 签名 。 




















9.2 签名 


必须 将 应 用 打包 成 一 个 .apk 文 件 并 使 用 数字 证 书 进行 签名 , 这 样 Android 才 会 考虑 运行 它 。 对 
于 模拟 器 和 你 的 测试 设备 来 说 如 此 ， 对 于 要 发 布 到 Play Store 的 程序 来 说 更 是 如 此 。 


你 可 能 会 说 ,“ 等 等 , 我 在 本 书 前 面 从 未 进行 过 打包 或 签名 呀 "。 实 际 上 , 你 这 样 做 了 。Android 
SDK 工 具 使 用 证 书 悄悄 地 进行 了 编译 和 签名 ， 而 该 证 书 是 Google 根 据 已 知 的 别名 和 密码 创建 的 。 
由 于 密码 是 已 知 的 ， 因 此 不 会 提示 你 输入 它 ， 你 甚至 根本 意识 不 到 它 的 存在 。 然 而 ， 对 于 要 发 布 
到 Play Store 的 应 用 , 不 能 使 用 调试 证 书 进行 签名 ,因此 你 不 能 再 依靠 这 个 证 书 ， 而 必须 要 创建 自 
己 的 证 书 。 


创建 证 书 的 方式 有 两 种 : 使 用 标准 Java 命 令 keytooL 和 jarsigner 手 动 创建 "， 使 用 Android 
Studio 自 动 创 建 。 这 里 只 介绍 第 二 种 。 


























从 屏幕 顶部 的 菜单 中 , 选择 Build> Generate Signed APK。 然后, 选择 要 对 其 进行 签名 的 模块 ， 
再 单 击 Next 按 钮 ， 如 图 9-1 所 示 。 





看 
网 Generate Signed APK Wizard | 


Module 


C3 graphics 

C3 localBrowser 
C3 locationTest 
C3 sensorTest 






C3 ticTacToevl 


C3 ticTacToev2 























图 9-1 


如 果 这 是 你 首次 给 应 用 签名 ， 请 在 下 一 个 屏幕 中 单 击 Create new 按 钮 。Android Studio 将 要 求 
你 指定 密 钥 存储 区 路 径 , 还 有 创建 密 钥 存储 区 及 其 包含 的 密 钥 所 需 的 一 系列 信息 ， 如 图 9-2 所 示 。 





GD http://d.android.com/tools/publishing/app-signing.html 
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££ 3 从 
贱 New Key Store 有 | 
Key store path: | C:\Users\Ed\hello.jks 
Password: | weeeeee Confirm，| eeeeeee 
Key 
Alias: android 
Password: = | eeeeeee Confirm: | eeeeeee 
Validity (years): 25 回 
-Certificate 





First and Last Name: | Hello Android 








Organizational Unit: | Mobile Development 








Organization: My Company 








City or Locality: My City 








State or Province: My State 

















| Country Code (XX): Us 


L_ 四 一 


图 9-2 千 万 不 要 把 密码 忘 
































提示 “请 将 密码 记录 下 来 并 放 在 安全 的 地 方 。 如 果 忘 记 了 密码 ， 密 钥 将 毫 无 用 处 ， 而 且 你 还 无 
法 更 新 应 用 。 








单 击 OK 按 钮 回 到 前 一 个 屏幕 ， 其 中 填写 了 所 有 的 值 ， 如 图 9-3 所 示 。 





1 = 
局 Generate Signed APK Wizard > Ex 


Key store path: Ci\Users\Ed\hello,jks 
Create new... Choose existing… 


Key store password: | weveeee 


























Key alias: android 图 
Key password: | [ 





口 Remember password 





Lo | EN oe ee 





图 9-3 ”这 个 文件 干 万 不 能 


对 于 你 编写 的 所 有 应 用 的 所 有 版 本 , 都 应 使 用 相同 的 密 钥 。 此 外 , 还 应 采取 合适 的 预防 措施 ， 
防止 私 钥 落 和 不 法 之 徒手 中 。 可 以 将 其 备份 到 Google 网 盘 或 其 他 安全 的 地 方 ， 以 防 万 一 。 


单 击 Next 按 钮 ， 再 单 击 Finish 按 钮 以 启动 签名 过 程 。 签 名 完成 后 ，Android Studio 将 显示 一 条 
消息 ， 如 图 9-4 所 示 。 
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的 Generate signed APK | 


人 Signed APK's generated successfully, 


ET Cs 


图 9-4 














注意 ”如 果 你 使 用 了 Google Maps API， 还 需要 从 Google 获 取 新 的 Maps API 密 钥 ， 因 为 它 与 你 的 
数字 证 书 相 关联 。 创建 签名 后 的 应 用 ， 按 在 线 说 明 获 取 Maps API 密 钥 "”， 修 改 
AndroidManifest.xml 文 件 以 使 用 这 个 新 密 钥 ， 然 后 再 次 对 程序 进行 签名 。 





完成 上 述 工作 后 ， 将 得 到 一 个 可 测试 和 发 布 的 APK 文 件 。 





9.3 测试 


Google 建 议 发 布 签名 的 发 行 版 之 前 ， 至 少 要 在 一 台 实 际 设备 上 进行 测试 ( 必须 承认 ， 我 很 少 
羊 做 )。 在 设备 上 安装 发 行 版 比 安装 调试 版 会 复杂 些 。 

Android Studio 提 供 了 一 项 名 为 build variants 的 功能 。 你 可 以 使 用 它 来 将 发 行 版 安装 到 设备 上 。 
但 它 不 能 与 Signed APK Wizard 协 同 工 作 ， 因 此 我 们 将 使 用 命令 行 工具 来 完成 这 项 工作 。 


首先 ， 打 开 一 个 命令 窗口 (也 叫 shell 或 终端 窗口 )， 并 切换 到 前 面 创 建 的 APK 签 名 文件 所 在 
的 目录 ， 如 图 9-5 所 示 。 


™ 
萝 Command Prompt El 


I@2/12/2815 <DIR> 
I@2/12/2815 PM 26.3?70 app-release.apk 
I@2/12/2815 M 6.734 app.-iml 
I@2/12/2815 <DIR> build 
I@2/12/2815 M 455 build.gradle 
I@2/12/2815 2 M 1.766 manifest-merger-release—-report .txt 
I@2/12/28615 @8: PM <DIR> src 
I@2/12/2815 68:409 PM 6.822 suggest .iml 
5 FileCs> 42-147 hytes 
4 DirCs? 8.443.834.368 bytes free 














入 
































sers\Ed\AndroidStudioProjects\suggest\app»C:\Users\Ed\AppData\Local\Android\ 
platform-tools\adb devices 
of devices attached 

I@94e@f37 device 


\Ed\AndroidStudioProjects\suggest\app’»C:\Users\Ed\AppData\Local\Android\ 
form-tools\adb uninstall org.example.suggest 


C:\Users\Ed\AndroidStudioProjects\suggest\app>C:\Users\Ed\AppData\Local\Android\ 
sdk\platform-tools\adbh install app-release.apk 
ET 

pkg: /data/local/tnp/app-release.apk 
Success 











GC:\Users\Ed\AndroidSstudioProjects\suggest\app>», 























图 9-5 ”80 后 希望 能 够 使 用 命令 行 工具 








CD https://developers.google.com/maps/documentation/android 
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将 设备 搬 和 人 计算机， 再 运行 命令 adb devices， 并 确定 能 够 看 到 该 设备 。 接 下 来 ， 运 行 命令 
adb uninstall your.package.name (请 将 your .package.name 替 换 为 AndroidManifest.xml 文 
件 中 指定 的 包 名 )， 将 应 用 的 调试 版 从 设备 中 删除 。 最 后 ， 运 行 命令 adb install 
app-release.apk (将 app-retease.apk 替 换 为 你 的 APK 文 件 的 名 称 )， 将 程序 复制 到 你 的 手机 
或 平板 电脑 。 

复制 应 用 后 , 在 你 的 设备 中 找到 应 用 列表 ， 再 轻 按 该 应 用 的 图 标 以 启动 它 。 通 过 测试 核实 它 
能 正确 地 运行 。 





























9.4 发 布 


Google Play Store 是 Google 提 供 的 一 项 服务 ， 可 以 使 用 它 来 发 布 所 有 的 程序 。 为 此 ， 首 先 需 
要 前 往 Developer Console" 注 册 成 为 注册 的 开发 人 员 。 这 需要 支付 少量 的 注册 费 。 


如 果 你 的 程序 是 收费 的 ， 还 需 向 一 家 支付 处 理 商 (payment processor ) 注册 ( 上 述 网 站 会 告 
诉 你 如 何 注册 )。 


现在 可 以 上 传 了 。 单 击 链接 Add new application， 并 填写 打开 的 表单 。 下 面 是 一 些 填写 技巧 。 


口 除非 有 充分 的 理由 ， 否 则 将 Locations 设 置 为 All Current and Future Countries。 鉴 于 不 断 有 
国家 加 入 ， 这 样 设置 能 够 让 你 的 应 用 在 所 有 国家 都 可 以 下 载 到 。 

口 在 “联系 人 信息 ”( Contact Information ) 中 ,不 要 填写 电话 号 码 。 所 有 Play Store 用 户 都 能 
看 到 这 项 信息 ， 他 们 遇 到 问题 时 就 会 拨打 这 个 号 码 。 当 然 ， 如 果 你 有 专用 的 电话 支持 人 
员 和 号 码 ， 就 不 需要 注意 这 一 点 了 。 


下 面 来 演示 发 布 第 11 章 的 示例 应 用 suggest 时 ， 我 是 如 何 填写 这 个 表单 的 。 


Upload new APK: (select Choose File and Upload) 
Language: English 
Title (English): Suggest 
Short description (English): 
Web service example generates amazingly accurate search suggestions. 
Description (English): 
Suggest matches a partial word or phrase you enter and comes 
up with a list of possible completions. Select one of the 
results to do a search on that item. 










































































The results are amazingly accurate, and are refined based on 
your location and searches other people are doing right now. 


This program is a sample from an upcoming edition of "Hello, 
Android" by Ed Burnette, published by the Pragmatic Programmers. 
It demonstrates calling web services, multi-threading, XML 
Parsing, and the Google Suggest API. 





QD http://play.google.com/apps/publish 
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AppLication Type: AppLications 
Category: Libraries Samp; Demo 


Content Rating: Everyone 

Website: http://pragprog.com/book/eband4 
Email: (my email address) 

Phone: (blank) 


Privacy Policy: (blank/not submitting a privacy policy) 
Price: Free 
Distribute in these countries: ALL 


单 击 Publish 按 钮 后 ， 应 用 将 出 现在 Google Play Store， 在 所 有 适用 的 设备 上 都 能 看 到 该 应 用 。 
Google 的 批准 流程 很 简单 ， 只 需 几 小 时 ( 而 不 是 几 周 ) 即 可 完成 ， 而 且 对 程序 的 功能 没有 限制 。 
准确 地 说 是 几乎 没有 限制 ， 因 为 你 必须 遵循 Google Play 开发 人 员 计 划 策 略 ( Developer Program 
Policies )", 否则 你 的 应 用 将 从 Google Play Store 删 除 。 其 中 一 项 规定 是 , 应 用 的 内 容 不 得 是 非法 、 
淫秽 、 令 人 反感 或 引发 暴力 、 不 适合 18 岁 以 下 的 人 员 观 看 的 。 另 外 ,还 必须 遵守 授权 运营 商 的 服 
务 条 款 。 确 实 有 一 些 应 用 因 用 户 或 运营 商 的 投诉 而 被 删除 掉 了 ,但 只 要 根据 常识 做 出 判断 ， 就 不 
用 担心 这 种 问题 。 


下 一 节 介绍 如 何 更 新 已 发 布 的 应 用 。 





















































9.5 更 新 


假设 应 用 发 布 到 Google Play Store 以 后 ， 你 需要 修改 它 。 最 简单 的 修改 就 是 修改 程序 的 元 数 
据 ， 即 标题 、 描 述 、 定 价 以 及 你 在 9.4 节 填写 的 所 有 信息 。 要 修改 非 代 码 信息 ， 只 需 在 Developer 
Console 的 列表 中 选择 程序 ， 执 行 修 改 ， 再 单 击 Submit Update 即 可 。 


如 果 有 新 的 代码 版 本 呢 ? 没 问 题 ， 你 也 可 以 在 这 个 页 面 中 上 传 它 。 但 这 样 做 之 前 ， 要 花 点 时 间 
确保 修改 了 AndroidManifestxml 文 件 中 的 两 个 版 本 号 ， 即 每 次 上 传 时 ， 都 将 android:versionCode 
的 值 加 1 (例如 ， 从 1 改 为 2 )， 并 将 属性 android:versionName 中 人 类 可 读 的 版 本 号 增加 合适 的 
值 (例如 , 修复 小 bug 后 , 将 该 版 本 号 从 1.0.0 改 为 1.0.1 )。 版 本 号 正确 无 误 , 并 重新 打包 和 签名 后 ， 
在 Developer Console 的 APK 部 分 单 击 按钮 Upload new APK， 然 后 单 击 Browse 按 钮 ， 找 到 新 的 .apk 
文件 ， 再 单 击 OK 按钮 即 可 将 其 发 送 到 服务 器 。 


建议 尽 可 能 只 是 偶尔 进行 更 新 。 请 牢记 下 面 两 个 矛盾 体 。 


口 频繁 更 新 会 让 用 户 高 兴 ， 因 为 这 让 他 们 认为 你 在 提供 支持 ， 并 倾听 了 他 们 的 建议 。 
口 频繁 更 新 也 会 让 用 户 讨厌 ， 因 为 他 们 将 遭受 更 新 通知 的 狂 麦 滥 炸 ， 进 而 可 能 将 频繁 骚扰 
他 们 的 应 用 印 载 。 

























































































GD http://play.google.com/about/developer-content-policy.html 
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9.6 “小 贴 士 


下 面 是 一 些 Google Play Store 小 贴 士 。 这 是 我 根据 自己 发 布 程 序 的 经 验 总 结 出 来 的 。 


口 可 以 将 收费 的 应 用 改 成 免费 的 ， 但 不 能 将 免费 应 用 改 成 收费 的 。 只 要 有 可 能 ， 就 应 提供 
程序 的 免费 ( 轻 量 级 ) 版 和 收费 ( 专业 ) 版 。 千 万 不 要 删除 免费 版 的 任何 功能 ， 和 否则 抗 
议 将 如 暴风 又 雨 般 袭 来 。 

口 不 能 使 用 发 布 收费 应 用 的 账户 购买 该 应 用 。 

口 阅读 用 户 留 下 的 所 有 评论 。 对 于 特别 粗鲁 或 低俗 的 垃圾 评论 ， 要 毫 不 犹豫 地 报告 。 确 保 

评论 区 域 干净 整洁 ， 以 接受 有 用 的 反馈 (无 论 是 赞扬 还 是 批评 )。 

口 不 要 气 角 。 用 户 可 能 会 毫 不 留情 ， 发 布 气愤 的 评论 时 尤其 如 此 。 厚 脸皮 和 幽默 感 是 无 价 

之 宝 。 

口 除 Google Play Store 之 外 ， 还 有 其 他 一 些 应 用 商店 。 除 发 布 到 Google Play Store 外 ， 同 时 
将 应 用 发 布 到 Amazon Appstore 和 其 他 深 受 欢迎 的 应 用 商店 ， 这 样 将 有 更 多 的 潜在 用 户 
看 到 它 。 





























9.7 快速 阅读 指南 


至 此 ， 你 已 经 具备 了 编写 成 功 Android 应 用 并 将 其 发 布 到 Google Play Store 所 需 的 全 部 技能 。 
你 可 以 就 此 止步 , 也 可 以 继续 往 下 阅读 , 学 习 如 何 使 用 Android 联 网 功能 (第 10 章 ) 和 Google Play 
服务 (第 12 章 )。 
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联 网 











接 下 来 的 几 章 介绍 较 高 级 的 主题 ， 如 网 络 访问 和 基于 位 置 的 服务 。 即 便 不 使 用 这 些 特性 , 也 
能 编写 很 多 有 用 的 应 用 , 但 如 果 使 用 它们 ， 只 需 做 很 少 的 工作 就 能 添加 大 量 功 能 ， 从 而 提高 程序 
的 价值 。 

用 手机 做 什么 呢 ?” 除 了 打 电 话 , 越 来 越 多 的 人 将 手机 用 作 移 动 网 络 设备 。 手机 和 平板 电脑 已 
经 超越 了 台式 机 ， 成 为 联网 的 首要 方式 ”。 

Android 手 机 装备 精良 , 非常 适合 用 于 连接 到 移动 网 络 。 首先 , Android 提 供 了 功能 齐备 的 Web 
浏览 器 。 该 浏览 器 基于 开源 项 目 Chromium”。 这 是 台式 机 浏览 器 Google Chrome 使 用 的 浏览 器 技 
术 。Chromium 是 Apple iPhone 、iPad 和 台式 机 浏览 器 Safari 使 用 的 WebKit* 的 一 个 分 支 ( fork )。 

其 次 ，Android 能 够 让 你 将 该 浏览 右 作 为 一 个 组 件 租 入 到 应 用 中 。 最 后 ，Android 能 够 让 你 的 
程序 访问 标准 网 络 服 务 ， 如 TCP/IP 套 接 字 ， 以 便 让 你 能 够 使 用 Google 、Yahoo 和 Amazon 提 供 的 
Web 服 务 以 及 Internet 上 的 众多 其 他 资源 (包括 你 自己 编写 的 资源 )。 

在 本 章 中 ， 你 将 通过 3 个 示例 学 习 如 何 集成 Android 的 Web 浏 览 功 能 。 

口 BrowserIntent: 学 习 如 何 使 用 Android 意 图 打开 外 部 Web 浏 览 
口 BrowserView: 了 解 如 何在 应 用 中 骸 入 浏览 器 。 
口 LocalBrowser: 学 习 芷 入 式 WebView 中 的 JavaScript 和 Android 程 序 中 的 Java 代 码 如 何 通 信 。 


第 11 章 将 介绍 如 何在 Android 程 序 中 使 用 基于 云 的 服务 和 资源 。 













































































10.1 使 用 意图 浏览 网 页 


使 用 Android 联 网 API 可 做 的 最 简单 的 事情 是 打开 一 个 浏览 器 , 并 在 其 中 显示 指定 的 网 页 。 你 
可 能 想 在 程序 中 提供 一 个 链接 ， 让 用 户 能 够 访问 你 的 主页 或 基于 服务 器 的 应 用 〈 如 预定 系统 )。 




















Wh http://sewat.ch/2353616 
© http://www.chromium.org/Home 
© http://webkit.org 
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在 Android 中 ， 只 需 编写 3 行 代 码 并 做 一 些 设置 工作 ， 就 能 完成 这 种 任务 。 


为 了 证 明 这 一 点 ， 下 面 来 编写 一 个 新 示例 BrowserIntent。 这 个 示例 程序 包含 一 个 文本 框 
( edit field ) 和 一 个 Go 按钮 。 用 户 在 文本 框 中 输入 URL 后 点 击 Go 按 钮 ， 就 可 以 打开 浏览 右 并 在 其 
中 显示 URL 指 定 的 网 页 ， 如 图 10-1 所 示 。 首 先 ， 新 建 一 个 项 目 ， 在 新 建 项 目 向 导 (New Project 
wizard ) 中 做 如 下 设置 。 


口 应 用 名 : BrowserIntent 

口 公司 域名 : example.org 

口 尺寸 : Phone and Tablet 

口 最 低 SDK: API 16: Android 4.1 (Jelly Bean ) 
口 添加 活动 : Blank Activity 

口 活动 名 : MainActivity 

口 布局 名 : activity_main 


口 标题 : Browser Intent 

















右上 玉昌 


Browserlntent 


http://www.android.com| 


Personalization is on. Touch for info. 














创建 基本 程序 后 ， 将 布局 文件 ( res/layout/activity_main.xml ) 修改 成 如 下 内 容 。 
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browserIntent/src/main/res/layout/activity_main.xml 


<?xml version="1.0" encoding="utf-8"?> 


<LinearLayout 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="horizontal" 

android:layout width="fill parent" 

android:layout height="fill parent"> 


<EditText 


android: 
android: 
android: 
android: 
android: 
android: 
android: 


<Button 


android: 
android: 
android: 
android: 


id="@+id/url_ field" 

layout width="0Qdip" 

layout height="wrap_ content" 
layout weight="1.0" 
lines="1" 
inputType="textUri" 
imeOptions="actionGo" /> 


id="@+id/go_ button" 

layout width="wrap_content" 
layout height="wrap_ content" 
text="@string/go button" /> 


</LinearLayout> 


这 里 定义 了 前 面 所 说 的 两 个 控件 : 一 个 EditText 和 一 个 Button。 


在 EditText 的 定义 中 , android:Layout _ weight="1.0" 让 这 之 个 文本 区 域 许 满 按 钮 左边 的 全 























部 水 平 空 间 ，android:1lines="1" 将 这 个 控件 的 高 度 限制 为 1 行 。 请 注意 ， 这 里 限制 的 不 是 用 户 
可 在 其 中 输入 的 文本 量 ， 而 是 显示 的 文本 量 。 


android:inputType="textUri" 和 android:ime0ptions="actionGo" 指 定 了 软 键盘 的 外 
观 ， 它 们 让 Android 将 标准 键盘 替换 为 这 样 的 键盘 ， 即 只 包含 方便 输入 网 址 的 按钮 。 有 关 输 入 选 











项 的 更 详细 信息 SA， 
与 往常 一 样 ， 


请 参阅 TextView 类 的 在 线 文 档 "。 
供用 户 阅 读 的 文本 应 放 在 资源 文件 res/values/strings.xml 中 。 





browserlntent/src/main/res/values/strings.xml 


<?xml version="1.0" encoding="utf-8"?> 


<resources> 


<string name="app_name">BrowserIntent</string> 
<string name="action settings">Settings</string> 
<string name="go button">Go</string> 


</resources> 


接 下 来 , 需要 编写 MainActivity 类 的 方法 onCreate()。 我 们 将 在 这 里 创建 月 


所 有 的 行为 。 如 果 你 不 想 输 入 这 些 代码 ， ne 下 载 完整 的 源 代码 。 











日 户 界面 并 指定 








GD http://d.android.com/reference/android/widget/TextView.html 
@) http://pragprog.com/book/eband4 
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browserIntent/src/main/java/org/example/browserintent/MainActivity.java 


Line 1 package org.example.browserintent; 


- import android.app.Activity; 
- import android.content.Intent; 
5 import android.net.Uri; 
- import android.os.Bundle; 
- import android.view.KeyEvent 
- import android.view.View; 
- import android.view.View.0nCLickListener; 
10 import android.view.inputmethod.EditorInfo; 
- import android.view.inputmethod.InputMethodManager; 
- import android.widget.Button; 
- import android.widget.EditText; 
- import android.widget.TextView; 
15 import android.widget.TextView.0nEditorActionListener; 
- public class MainActivity extends Activity { 
S private EditText urlText; 
- private Button goButton; 
- @Override 
20 public void onCreate(Bundle savedInstanceState) { 
- super.onCreate(savedInstanceState); 
- setContentView(R.layout.activity main); 
// 获取 指向 各 个 用 户 界面 元 素 的 句柄 
- urlText = (EditText) findViewById(R.id.url field); 
25 goButton = (Button) findViewById(R.id.go button); 
E // 设置 事件 处 理 程序 
- goButton.setOnClickListener(new OnClickListener() { 
A public void onClick(View view) { 
- openBrowser(); 
30 } 
- }); 
- urlText.setOnEditorActionListener(new OnEditorActionListener() { 
- public boolean onEditorAction(TextView v, int actionId, 
- KeyEvent event) { 
35 if (actionId == EditorInfo.IME ACTION GO) { 
- openBrowser(); 
- InputMethodManager imm = (InputMethodManager) 
- getSystemService(INPUT METHOD SERVICE); 
- imm.hideSoftInputFromWindow(v.getwindowToken(), 0); 
40 return true; 
} 


- return false; 





在 方法 onCreate() 中 ,第 22 行 调用 了 setContentView() 来 加 载 布局 资源 定义 的 视图 ， 第 
24~25 行 调用 findViewById() 来 获取 指向 两 个 用 户 界 面 控件 的 句柄 。 

第 27 行 让 Android 在 用 户 按 下 Go 按钮 ( 触摸 该 按钮 或 导航 到 该 按钮 后 按 中 间 的 D-pad 按钮 ) 时 
运行 一 些 代码 一 一 稍 后 将 定义 的 方法 openBrowser()。 
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如 果 用 户 输入 网 址 后 , 按 下 了 软 键盘 中 的 “链接 ”按钮 或 物理 键盘 中 的 回 车 键 , 也 应 该 打开 

浏览 器 。 为 此 , 我 们 定义 了 男 一 个 始 于 第 32 行 的 监听 器 , 它 在 用 户 在 文本 框 中 执行 操作 时 被 调用 。 

如 果 用 户 按 下 的 是 “链接 ”按钮 ， 就 调用 方法 openBrowser() 来 打开 浏览 器 ; 否则 就 返回 false， 
让 文本 框 以 正常 的 方式 处 理事 件 。 


接 下 来 是 你 期 待 已 久 的 部 分 : 方法 openBrowser() 。 像 前 面 所 说 的 一 样 , 它 只 包含 3 行 代 码 。 





browserlntent/src/main/java/org/example/browserintent/MainActivity.java 
/** 打开 浏览 器 并 浏览 到 文本 框 中 指定 的 URL */ 
private void openBrowser() { 
Uri uri = Uri.parse(urlText.getText().toString()); 
Intent intent = new Intent(Intent.ACTION VIEW, uri); 
startActivity(intent); 
S 


第 1 行将 用 户 输入 的 网 址 转换 为 字符 串 ( 如 http://www.android.com )， 再 将 其 转换 为 统一 资源 
标识 符 ( URI )。 





注意 ”输入 网 址 时 ， 别 省 略 URL 的 http:/ 部 分 ， 否 则 程序 将 前 溃 ,， 因 为 Android 不 知道 如 何 处 理 地 
址 。 在 实际 程序 中 ， 可 以 在 用 户 省 略 了 http:/ 时 自动 将 其 添加 上 。 








第 2 行 用 于 新 建 一 个 Intent 实 例 ， 将 操作 指定 为 ACTION_VIEW， 并 将 要 查看 的 对 象 指定 为 前 
面 创建 的 Uri 实 例 。 最 后 ， daa tei 

活动 Browser 启 动 后， 将 创建 自己 的 视图 ( 如 图 10-2 所 示 )， 并 允许 你 的 应 用 进入 后 台 。 用 户 
按 下 “后 退 ” 按 钮 时 ， 浏览 紫 窗 口 将 消失 ， 而 你 的 应 用 将 恢复 运行 。 





Powering screens of all sizes 


【>] Watch the video 
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如 果 要 同时 显示 你 的 应 用 的 用 户 界面 和 网 页 , 该 如 何 处 理 呢 ? 在 Android 中 , 可 使 用 WebView 
类 来 实现 这 个 目标 。 


10.2 ”使 用 WebView 来 浏览 网 页 


在 台式 机 中 ,Web 浏 览 带 是 庞大 而 复杂 的 程序 , 它 包 含 各 种 功能 ( 如 书签 、 择 件 、Flash 动 画 、 
选项 卡 、 滚 动 条 、 打 印 等 )， 需 要 消耗 大 量 的 内 存 。 

我 在 开发 Eclipse 项 目 时 ， 有 人 建议 将 一 些 文本 视 图 替换 为 嵌入 式 Web 浏 览 器 。 我 认为 他 们 简 
直 疯 了 。 理 由 是 ,将 文本 视图 进行 改进 ,使 其 支持 斜体 、 表 格 等 缺失 的 功能 :是 更 合理 吕 ? 


事实 证 明 他 们 并 没有 疯 ， 原 因 如 下 。 


口 删 掉 除 基本 演 染 引擎 外 的 其 他 一 切 后 ，Web 浏 览 器 更 为 精炼 。 
口 如 果 改 进 文本 视图 ， 不 断 添加 浏览 器 引擎 提供 的 功能 ， 最 终 得 到 的 要 么 是 过 于 复杂 而 胱 
肿 的 文本 视图 ， 要么 是 动力 不 足 的 浏览 絮 


Android 提 供 了 一 个 Chromium/WebKit 浏 览 嚣 引擎 包装 器 一 一 WebView, 使 用 它 可 以 获得 浏览 
器 的 功能 ， 而 付出 的 开销 却 很 小 。 


WebView 的 工作 原理 与 其 他 Android 视 图 很 像 , 但 它 包含 一 些 浏 览 器 特有 的 方法 。 下 面 将 创建 
前 一 个 实例 的 馆 入 版 ， 以 帮助 你 了 解 WebView 的 工作 原理 。 我 们 将 这 个 版 本 命名 为 BrowserView 
( 而 不 是 BrowserIntent )， 因 为 它 使 用 的 是 租 入 式 视 图 而 不 是 意图 。 首 先 ， 使 用 如 下 设置 新 建 一 个 
项 日 口 






















































































口 应 用 名 : BrowserView 

公司 域名 : example.org 

口 尺寸 : Phone and Tablet 

口 最 低 SDK: API 16: Android 4.1 ( Jelly Bean ) 
口 添加 活动 : Blank Activity 

口 活动 名 : MainActivity 

口 布局 名 : activity_main 


口 标题 : Browser View 


BrowserView 的 布局 文件 与 BrowserIntent 的 布局 文件 类 似 ， 但 在 最 后 面 多 了 一 个 WebView。 








browserView/src/main/res/layout/activity_main.xml 

<?xml version="1.0" encoding="utf-8"?> 

<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent"> 
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<LinearLayout 
android:orientation="horizontal" 
android:layout width="fill parent" 
android:layout height="wrap content"> 
<EditText 
android:id="@+tid/url field" 
android:layout width="0Qdip" 
android:layout height="wrap_ content" 
android:layout weight="1.0" 
android:lines="1" 
android:inputType="textUri" 
android:imeOptions="actionGo" /> 
<Button 
android:id="@+id/go button" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:text="@string/go button" /> 
</LinearLayout> 
<WebView 
android:id="@+id/web view" 
android:layout width="fill parent" 
android:layout height="0Qdip" 
android:layout weight="1.0" /> 
</LinearLayout> 


为 了 让 所 有 界面 元 素 都 处 于 正确 的 位 置 ， 我 们 使 用 了 两 个 LinearLayout 控 件 。 外 面 的 
LinearLayout 控 件 将 屏幕 分 为 上 下 两 部 分 。 其 中 ， 上 半 部 分 包含 文本 区 域 和 按钮 ， 而 下 半 部 分 
包含 WebView。 内 部 的 LinearLayout 与 前 一 个 示例 相同 : 将 文本 区 域 放 在 左边 ， 并 将 按钮 放 在 
右边 。 


BrowserView 的 方法 onCreate( ) 与 前 一 个 示例 相同 ， 但 还 获取 了 指向 新 增 视图 的 句柄 。 

















browserView/src/main/java/org/example/browserview/MainActivity.java 


package org.example.browserview; 
J ese 


1/ 


public class MainActivity extends Activity { 
private WebView webView; 


了 下 Su 

@Override 

public void onCreate(Bundle savedInstanceState) { 
J em 
webView = (WebView) findViewById(R.id.web view); 
EB Su bes 

} 


然而 ， 方 法 openBrowser( ) 就 不 同 了 。 
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browserView/src/main/java/org/example/browserview/MainActivity.java 

/** 打开 浏览 器 并 浏览 到 文本 框 中 指定 的 URL */ 

private void openBrowser() { 
webView.getSettings().setJavaScriptEnabled(true); 
webView.loadUrl (urlText.getText().toString()); 

} 


方法 LoadUrL() 让 浏览 需 引 擎 加 载 并 显示 指定 地 址 的 网 页 。 这 个 方法 会 立即 得 到 返回 ， 虽 然 
实际 加 载 工作 需要 一 段 时 间 才 能 完成 。 
别 忘 了 更 新 字符 串 资源 。 











browserView/src/main/res/values/strings.xml 

<?xml version="1.0" encoding="utf-8"?> 

<resources> 
<string name="app_name">BrowserView</string> 
<string name="action settings">Settings</string> 
<string name="go button">Go</string> 

</resources> 


这 个 程序 还 有 一 个 地 方 需要 修改 。 在 文件 AndroidManifest.xml 中 ， 在 标签 <application> 前 
面 添 加 如 下 一 行 。 








browserView/src/main/AndroidManifest.xml 


<uses-permission android:name="android.permission.INTERNET" /> 


如 果 不 这 样 做 ，Android 将 禁止 应 用 访问 Internet， 进 而 显示 错误 Web page not available ( 网 页 
不 可 用 )。 





1// 小 乔 爱 问 : 


局 ”Browserlntent 为 何不 需要 <uses-permission>? 


在 前 一 个 示例 (BrowserIntent) 中 ， 只 是 触发 意图 来 请 求 另 一 个 应 用 显示 网 页 ， 该 应 用 
(浏览 器 ) 需要 在 其 AndroidManifest.xml 中 请 求 Internet 权限 。 





现在 尝试 运行 这 个 程序 ， 并 输入 以 http:/ 打 头 的 有 效 网 址 。 当 你 按 回 车 键 或 Go 按钮 时 ， 指 定 
的 网 页 将 显示 出 来 ， 如 图 10-3 所 示 。 


根据 你 输入 的 网 址 ， 可 能 需要 在 未 尾 添加 字符 /， 这 是 因为 我 们 没有 处 理 重 定向 。 


WebView 包 含 数 十 个 方法 ， 你 可 以 使 用 它们 来 控制 显示 的 内 容 或 收 到 有 关 状 态 变化 的 通知 。 
完整 的 方法 列表 请 参阅 WebView 的 在 线 文档 "。 下 面 是 你 很 可 能 需要 使 用 的 方法 。 


























人 http://d.android.com/reference/android/webkit/WebView.html 
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Powering screens of all sizes 
人 Watch the video 


Coming to watches, phones, tablets， 
TVs,and cars near you 





Emma 


图 10-3 





口 addjavascriptInterface(): 允许 JavaScript 访 问 Java 对 象 (下 一 节 将 进行 更 详细 的 


介绍 )。 


口 createSnapshot(): 创建 当前 网 页 的 屏幕 截图 。 

口 getSettings(): 返回 一 个 用 于 控制 设置 的 WebSettings 对 象 。 

口 loadData(): 将 指定 的 字符 串 数据 加 载 到 浏览 器 中 。 

口 LoadDatawithBaseURL() : 使 用 基本 URL 加 载 指定 的 数据 。 

口 LoadUrtL() : 加 载 指定 URL 处 的 网 页 。 

口 setDownloadListener(): 为 下 载 事 件 ( 如 用 户 下 载 ZIP 或 APK 文 件 ) 注册 回调 函数 。 
口 setWebChromeClient(): 为 需要 在 WebView 外 面 执 行 的 事件 ( 如 更 新 标题 或 进度 条 , 或 
者 打开 JavaScript 对 话 框 ) 注册 回调 函数 。 

口 setWebViewClient(): 允许 应 用 在 浏览 器 中 设置 钩子 ， 以 拦截 资源 加 载 、 按 键 或 申请 授 
权 等 事件 。 

口 stopLoading(): 停止 加 载 当 前 网 页 。 


使 用 WebView 控 件 时 , 可 执行 的 最 强大 的 任务 是 , 在 它 和 包含 它 的 Android 应 用 之 间 通 信 。 下 
面 就 来 更 详细 地 介绍 这 项 功能 。 



































10.3 在 JavaScript 和 Java 之 间 交 互 
Android 设 备 有 很 多 卓越 的 功能 ， 如 存储 本 地 数据 、 绘 制图 形 、 播 放 音 乐 、 接 打 电 话 和 定位 。 
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如 果 能 够 在 网 页 中 访问 这 些 功能 ， 那 该 多 好 啊 ! 使 用 艇 入 式 WebView 控 件 ， 你 就 能 够 实现 。 

这 里 的 关键 是 WebView 类 的 方法 addJavascriptInterface()。 使 用 它 可 以 扩展 般 入 式 浏览 
器 中 的 文档 对 象 模 型 ( DOM，Document Object Model )， 还 可 以 定义 JavaScript 代 码 能 够 访问 的 新 
对 象 。JavaScript 代 码 调用 这 种 对 象 的 方法 时 ， 将 实际 调用 Android 程 序 中 的 方法 。 

你 也 可 以 在 Android 程 序 中 调用 JavaScript 方 法 。 为 此 ， 只 需 调 用 方法 LoadUrL() ， 并 传人 形 
式 为 javascripticode-to-execute 的 UREL 即 可 。 这 样 ， 浏 览 器 就 可 以 在 当前 网 页 中 执行 指定 的 
JavaScript 表 达 式 ， 而 不 是 切换 到 新 的 网 页 。 你 可 以 调用 方法 、 修 改 JavaScript 变 量 、 修 改 浏览 
文档 一 一 应 有 尽 有 。 
































在 JavaScript 中 调用 Java 的 风险 


每 当 允 许 网 页 访问 本 地 资源 或 调用 浏览 器 沙 箱 外 的 函数 时 ,一定 要 仔细 考虑 这 样 做 带 来 
的 安全 后 果 。 例如 , 你 不 会 希望 创建 的 方法 让 JavaScript 根 据 任何 路 径 名 读 取 相应 的 数据 ， 因 
为 这 可 能 会 将 机 密 数 据 暴露 给 知道 该 方法 和 文件 名 的 恶意 网 站 。 

下 面 是 一 些 需要 牢记 的 要 点 。 首 先 , 不 要 依赖 不 明确 的 安全 性 ,而 应 对 哪些 网 页 可 使 用 
你 的 方法 进行 限制 ， 并 对 这 些 方法 可 执行 的 操作 进行 限制 。 其 次 ， 牢 记 如 下 安全 黄金 法 则 : 
不 要 采用 排除 法 , 而 应 采用 包含 法 。 换 句 话说, 不 要 尝试 去 检查 别人 可 能 要 求 你 做 的 所 有 坏 
事 (如 查询 中 的 非法 字符 )， 这 难免 会 挂 一 漏 万 ; 相反 ,应 只 允许 别人 做 你 知道 安全 的 事情 ， 
其 他 的 事情 都 不 允许 做 ( 即 检查 查询 只 包含 合法 的 字符 )。 








为 演示 WebView 中 的 JavaScript 和 Android 程 序 中 的 Java 如 何 相互 调用 ， 下 面 来 创建 一 个 程序 ， 
它 一 半 是 HTML/JavaScript， 一 半 是 Android， 如 图 10-4 所 示 。 在 这 个 应 用 的 窗口 中 ， 上 半 部 分 是 
一 个 WebView 控 件 , 下 半 部 分 是 Android 用 户 界 面 的 TextView 和 Button。 用 户 点 击 按钮 或 链接 时 ， 
将 发 生 两 个 环境 之 间 的 相互 调用 。 


首先 ， 使 用 如 下 设置 新 建 一 个 程序 。 


口 应 用 名 : LocalBrowser 

口 公司 域名 : example.org 

口 尺寸 : Phone and Tablet 

口 最 低 SDK: API 16: Android 4.1 ( Jelly Bean ) 
口 添加 活动 : Blank Activity 

口 活动 名 : MainActivity 

口 布局 名 : activity_main 


口 标题 : Local Browser 
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[Cv 写 自 10:56 
LocalBrowser 
WebView 


Display JavaScript alert 
Call Android from JavaScript 


Hello from Android 


TextView 
CALL JAVASCRIPT FROM ANDROID 


Hello from Browser 


Alert from JavaScript 





O 


图 10-4 


这 个 程序 的 用 户 界面 分 为 两 部 分 。 第 一 部 分 是 在 Android 布 局 文件 res/layout/activity_main.xml 
中 定义 的 。 








localBrowser/src/main/res/layout/activity_main.xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent"> 
<WebView 
android:id="@+id/web view" 
android:Layout width="fill parent" 
android:layout height="fill parent" 
android:layout weight="1.0" /> 
<LinearLayout 
android:orientation="vertical" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:layout weight="1.0" 
android:padding="5sp"> 
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<TextView 
android:layout width="fill parent" 
android:layout height="wrap_ content" 
android:textSize="24sp" 
android:text="@string/textview" /> 

<Button 
android:id="@+id/button" 
android:text="@string/call javascript from android" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:textSize="18sp" /> 

<TextView 
android:id="@+id/text view" 
android:layout width="fill parent" 
android:layout height="wrap_content" 
android:textSize="18sp" /> 

</LinearLayout> 
</LinearLayout> 


第 二 部 分 是 将 加 载 到 WebView 中 的 文件 index.html。 这 个 文件 存储 在 目录 assets 而 不 是 res 中 ， 
因为 它 并 非 编译 型 资源 。 程 序 安装 时 ， 目 录 assets 的 内 容 都 将 被 原封 不 动 地 复制 到 本 地 存储 区 。 
这 个 目录 用 于 存储 HTML 、 图 像 和 脚本 的 本 地 副本 ， 浏 览 器 无 需 连 接 到 网 络 就 能 查看 它们 。 


在 Android Studio 中 ， 创 建 目 录 assets 时 稍微 有 点 麻烦 。 首 先 必须 将 项 目 视 图 切换 到 Project 模 
式 ， 以 便 能 够 看 到 实际 目录 。 为 此 ,可 单 击 窗口 顶部 的 模式 标签 。 切 换 到 目录 app/srcmain ， 右 击 
main， 选 择 New>Directory， 输 入 目录 名 (assets )， 再 单 击 OK 按 钮 。 接 下 来 ， 返 回 到 Android 模 
式 ， 右 击 assets 并 新 建 一 个 文件 。 

















yy 
































localBrowser/src/main/assets/index.html 


Line 1 <htmL> 
- <head> 
- <script language="JavaScript"> 
function callJS(arg) { 
5 document .getELementById('repLaceme ') .innerHTML = arg; 
} 
- </script> 
-</head> 
- <body> 
10 <h2>WebView</h2> 
- <p> 
- <a href="#" onclick="window.alert('Alert from Java9cript ' ) "> 
Display JavaScript alert</a> 
- </p> 
15 <p> 
- <a href="#" onclick="window.android.callAndroid('Hello from Browser')"> 
Call Android from JavaScript</a> 
- </p> 
- <p id="replaceme"> 
20 </p> 
- </body> 
- </htmL> 
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在 文件 index.html 中 ， 第 4 行 定 义 了 Android 程 序 将 调用 的 函数 cal1JS()。 这 个 函数 接受 一 个 





字符 串 参 数 ， 并 将 其 搬入 到 第 19 行 的 标签 repLaceme 处 。 








在 图 10-4 中 ， 有 两 个 HTML 链 接 ， 它 们 是 在 始 于 第 12 行 的 代码 中 定义 的 。 第 一 个 链接 调用 标 














准 函 数 window.atert () 来 打开 一 个 窗口 ， 并 在 其 中 显示 一 条 简短 的 消息 。 第 二 个 链接 是 在 第 16 
行 定 义 的 ， 它 调用 window.android 对 象 的 方法 caLLAndroid() 。 如 果 在 常规 Web 浏 览 器 中 加 载 
该 网 页 ， 对 象 window.android 将 是 未 定义 的 。 然 而 ， 由 于 我 们 在 Android 应 用 中 仍 入 了 一 个 浏览 


Bi 
有 AF， 




















因此 可 以 定义 这 个 对 象 ， 让 网 页 能 够 使 用 它 。 
接 下 来 将 注意 力 转向 MainActivity 类 的 Android 人 代码。 下面 是 基本 轮廓 ， 其 中 包含 后 面 




















要 





的 所 有 :import 语句 。 


Line 1 


localBrowser/src/main/java/org/example/localbrowser/MainActivity.java 


package org.example.localbrowser; 


- import android.app.Activity; 
- import android.os.Bundle; 


import android.os.Handler; 


- import android.util.Log; 

- import android.view.View; 

- import android.view.View.0nCLickListener; 
- import android.webkit.JavascriptInterface; 


import android.webkit.JsResult; 


- import android.webkit.WebChromeClient; 
- import android.webkit.WebView; 

- import android.widget.Button; 

- import android.widget.TextView; 


import android.widget.Toast; 


- public class MainActivity extends Activity { 


20 


25 


30 


35 


private static final String TAG = "LocalBrowser"; 
private final Handler handler = new Handler(); 
private WebView webView; 

private TextView textView; 

private Button button; 


GOverride 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 


// 获取 屏幕 上 的 Android 榨 件 

webView = (WebView) findViewById(R.id.web view) ; 
textView = (TextView) findViewById(R.id.text view); 
button = (Button) findViewById(R.id.button); 

// onCreate 的 其 他 代码 …… 


} 
注意 到 第 19% 行 初始 化 了 一 个 HandLer 对 象 。 JavaScript 调 用 是 在 浏览 器 专用 的 特殊 线程 中 进行 
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的 ， 而 Android 用 户 界 面 调用 只 能 在 主 (GUI ) 线程 中 进行 。 使 用 Handler 类 来 实现 这 种 切换 。 
线程 是 一 个 执行 上 下 文 ， 计 算 机 代码 在 其 中 顺序 执行 ( 执行 完 一 条 语句 后 再 执行 男 一 条 )。 
由 于 软件 和 硬件 技术 的 进步 ，Android 等 现代 操作 系统 可 同时 运行 很 多 线程 。 其 中 一 个 是 专用 的 
前 台 (或 GUI ) 线程 , 所 有 用 户 界面 操作 都 是 在 这 个 线程 中 执行 的 。 其 他 所 有 线程 都 是 后 台 线 程 ， 
用 于 执行 长 时 间 运 行 的 操作 ( 如 网 络 1/O )， 以 免 影响 用 户 体验 。 
要 在 JavaScript 中 调用 Android Java 代 码 , 需要 定义 一 个 普通 的 Java 对 和 象 ( plain old Java object )， 
其 中 包含 一 个 或 多 个 方法 ， 如 下 所 示 。 









































localBrowser/src/main/java/org/example/localbrowser/MainActivity.java 
/+** 暴露 给 JavaScript 的 对 象 */ 
private class AndroidBridge { 
@JavascriptInterface // 在 Android 4.2+ 中 必 不 可 少 
public void callAndroid(final String arg) { // 必须 为 final 
handler.post(new Runnable() { 
public void run() { 
Log.d(TAG, "callAndroid(" + arg + ")"); 
textView.setText (arg); 
} 
}); 


} 

JavaScript 调 用 方法 callAndroid() 时 ,应 用 将 新 建 一 个 Runnable 对 象 ， 并 使 用 
Handler.post() 将 其 发 送 到 主线 程 的 运行 队列 。 主 线程 一 有 机 会 就 会 调用 方法 run()， 而 这 个 
方法 调用 setText( ) 来 修改 TextView 控 件 显示 的 文本 。 现 在 ,该 在 方法 onCreate() 中 将 一 切 组 
合 起 来 了 。 首先 , 启用 JavaScript ( 它 默认 被 禁用 ), 并 向 JavaScript 注 册 前 面 定义 的 AndroidBridge。 





localBrowser/src/main/java/org/example/localbrowser/MainActivity.java 
// 在 内 识 的 浏览 器 中 启用 Java9cript 
webView.getSettings().setJavaScriptEnabled(true); 


// 在 浏览 器 中 向 Java9Script 暴 露 一 个 ]ava 对 象 
webView.addJavascriptInterface(new AndroidBridge()， 
"android"); 


接 下 来 ,创建 一 个 匿名 的 WebChromeClient 对 象 ， 并 使 用 方法 setWebChromeClient() 
注册 它 。 





localBrowser/src/main/java/org/example/localbrowser/MainActivity.java 
// 创建 一 个 函数 ， 这 个 函数 将 在 JavaScript 试 图 打开 提示 窗口 时 被 调用 
webView.setWebChromeClient(new WebChromeClient() { 
@Override 
public boolean onJsAlert(final WebView view, 
final String url, final String message, 
JsResult result) { 
Log.d(TAG, "onJjsAlert(" + view + ", "+ Url+" 
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+ message + ", " + result + ")"); 
Toast.makeText (MainActivity.this, message, Toast.LENGTH LONG).show(); 
result.confirm(); 
return true; // 已 处 理 过 
} 
}); 
在 这 里 ， 术 语 chrome 指 的 是 浏览 器 窗口 的 所 有 点 绥 品 〈trimmings )。 如 果 这 是 一 个 五 脏 俱全 
的 浏览 器 客户 端 ， 将 需要 处 理 导航 、 书 签 、 菜 单 等 。 在 这 里 ， 我 们 只 想 改 变 浏览 器 〈 使 用 
window.alert() ) 试图 打开 JavaScript 提 示 框 时 发 生 的 情况 。 在 onJsAtLert() 中 ， 使 用 Android 


类 Toast 创 建 一 个 消息 窗口 。 这 个 窗口 显示 一 小 会 儿 之 后 就 会 消失 。 
配置 好 webView 后 ， 便 可 使 用 LoadUrt () 来 加 载 前 述 本 地 网 页 。 















































localBrowser/src/main/java/org/example/localbrowser/MainActivity.java 


// 加 载 本 地 素材 中 的 网 页 
webView.loadUrl("file:///android asset/index.html"); 


对 于 Android 的 浏 筑 器 引 警 来 说 ， 格式 为 fle://android asset/filename( 请 注意 ， 其 中 包含 3 个 
和 斜 杠 ) 的 URL 具 有 特殊 含义 。 你 可 能 猜 到 了 ， 它 们 表示 目录 assets 中 的 文件 。 在 这 里 加 载 的 是 前 
面 定义 的 文件 index.html。 


在 示例 LocalBrowser 中 ， 文 件 res/values/strings.xml 的 内 容 如 下 。 











localBrowser/src/main/res/values/strings.xml 

<?xml version="1.0" encoding="utf-8"?> 

<resources> 
<string name="app_name">LocalBrowser</string> 
<string name="action settings">Settings</string> 
<string name="textview">TextView</string> 
<string name="call javascript from android"> 

Call JavaScript from Android 

</string> 

</resources> 


我 们 必须 做 的 最 后 一 项 工作 是 , 设置 屏幕 底部 的 按钮 ,使 其 执行 JavaScript 调 用 ( 在 Java 中 调 
HJavaScript )。 























— 





localBrowser/src/main/java/org/example/localbrowser/MainActivity.java 
// 用 户 点 击 按钮 时 ， 将 在 Android 端 调用 这 个 函数 
button.setOnClickListener(new OnClickListener() { 
public void onClick(View view) { 
Log.d(TAG, "onClick(" + view + ")"); 
webView.loadUrl("javascript:callJsS('Hello from Android')"); 
} 
}); 


为 此 ， 使 用 set0nCLickListener() 为 按钮 设置 一 个 点 击 监听 器 。 按 钮 被 点 击 时 ， 将 调用 
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onCLick() ， 而 这 个 方法 又 会 转 而 调用 WebView.tLoadUrL() ， 并 传人 一 个 要 在 浏览 器 中 执行 的 
JavaScript 表 达 式 。 这 个 表达 式 调用 index.html 中 定义 的 函数 catL]S() 。 


现在 运行 这 个 程序 。 当 你 点 击 链接 Display JavaScript alert 时 ， 将 出 现 一 个 Android 消息 窗口 ; 
当 你 点 击 链接 Call Android from JavaScript 时 ， 字 符 串 Hello from Browser 将 显示 在 一 个 Andriod 
TextView 控 件 中 ; 最 后 ， 当 你 点 击 按钮 Call JavaScript fom Android 时 ， 字 符 串 Hello from Android 
将 被 发 送 给 浏览 器 ， 而 浏览 器 将 把 它 插 入 HTML 并 显示 在 网 页 底部 。 





10.4 快速 阅读 指南 


在 本 章 中 ， 你 学 习 了 两 种 显示 Web 内 容 的 方式 : 启动 意图 来 打开 一 个 Web 浏 览 需 ， 以 及 在 应 
用 中 舰 入 一 个 Web 浏 览 器 。 你 还 学 习 了 如 何 使 用 WebView 来 显示 本 地 内 容 ， 以 及 如 何 使 用 
JavaScript 在 网 页 和 Java 之 间 通 信 。Apache Cordova" 等 跨 平台 工具 包 就 使 用 了 这 种 技术 。 

有 时 候 ， 你 不 需要 显示 网 页 ， 而 只 想 访 问 服务 器 提供 的 Web 服 务 或 其 他 数据 。 在 下 一 章 ， 你 
将 学 习 如 何 实现 这 一 目标 。 


如 果 你 需要 一 个 可 带 着 去 溜达 的 程序 ， 可 跳 到 第 12 章 。 



























































CD http://cordova.apache.org 
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近年 来 ， 越 来 越 多 的 功能 被 移 到 了 云端 。Amazon Web Services 提 供 了 云 计 算 和 云 存 储 ， 这 是 
项 数 十 亿美 元 的 业务 ; Google Apps 为 数 百 万 中 小 型 企业 处 理 办 公 功 能 ; Microsoft 正 致力 于 将 其 
无 处 不 在 的 Office 套 件 变 成 云 服务 。 这 些 平台 有 一 个 共同 之 处 ， 那 就 是 都 采用 了 遵循 REST 的 Web 
服务 接口 。 

REST ( REpresentational State Transfer ) 的 含义 因 人 而 异 , 但 最 具 现 实意 义 的 定义 是 ， 这 是 一 
种 在 Internet 上 创建 服务 的 技术 ， 它 能 让 用 户 通 过 TCP/IP ( Transmission Control Protocol/Internet 
Protocol， 传 输 控制 协议 /Internet 协 议 ) 连接 发 送 简 单 的 HTTP ( HyperText Transfer Protocol， 超 文 
本 传输 协议 ) 来 完成 任务 。 简 单 地 说 ,网 上 运行 着 服务 器 ， 用户 可 以 使 用 标准 协议 通过 标准 通信 
端口 连接 到 它 ， 然 后 向 它 发 送 请 求 和 命令 并 获得 结果 。 

你 每 天 都 在 使 用 的 Web 服 务 器 ( 如 google.com 和 microsoft.com ) 就 是 一 种 Web 服 务 。 客户 端 ( 浏 
览 器 ) 建立 到 端口 80 或 443 的 连接 ， 请 求 提供 网 页 或 其 他 资源 ， 获 得 结果 ， 再 断 开 连接 。 整 个 万 
维 网 ( World Wide Web ) 就 是 建立 在 这 种 简单 架构 基础 之 上 的 。 

在 本 章 中 , 你 将 学 习 如 何在 Android 程 序 中 建立 到 Web 服 务 的 网 络 连接 , 进而 在 应 用 中 添加 一 
系列 新 功能 。 






















































































11.1 使 用 Web 服务 


Android 提 供 了 一 整套 Java 标 准 联网 API ( 如 java.net.HttpURLConnection 包 ), 供 你 在 程序 中 使 
用 。 最 棘手 的 是 进行 异步 调用 ， 让 程序 的 用 户 界 面 在 任何 时 候 都 能 快速 响应 。 


如 果 在 用 户 界面 代码 中 间 进 行 阻塞 式 网 络 调用 , 结果 将 如 何 呢 ? 应 用 可 能 突然 间 不 响应 任何 
事件 , 如 触摸 或 按钮 点 击 。 在 用 户 看 来 , 应 用 就 像 是 停止 了 。 显然 , 你 必须 避免 这 样 的 情况 发 生 。 


java.util.concurrent 包 非常 适合 用 于 完成 这 种 工作 。 这 个 包 最 初 是 Doug Lea 开 发 的 一 个 独立 
库 ， 后 被 加 入 到 Java 5 中 。 它 支持 并 发 编程 ， 但 抽象 程度 比 Java 类 Thread 高 。ExecutorService 
类 为 你 管理 着 一 个 或 多 个 线程 ， 你 需要 做 的 只 是 向 它 提交 要 执行 的 任务 (Runnable 或 Callable 
实例 )。ExecutorService 将 返回 一 个 Future 实 例 。 它 是 一 个 引用 ， 指 问 任 务 将 返回 的 未 来 ( 当 
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前 未 知 的 ) 值 。 可 以 限制 创建 的 线程 数 ， 还 可 以 在 必要 的 时 候 中 断 正在 运行 的 任务 。 


为 演示 这 些 概 念 , 下 面 来 创建 一 个 有 趣 的 小 程序 , 它 调用 Google Suggest API。 你 可 能 注意 到 
了 , 在 google.com 或 bing.com 等 搜索 网 站 搜索 时 ， 输 入 关键 字 后 ， 你 将 立即 看 到 补 全 建议 。 例 如 ， 
如 果 你 输入 字母 and， 可 能 会 看 到 一 些 与 Android 相 关 的 建议 。 这 是 使 用 Web 服 务实 现 的 。 

其 工作 原理 如 下 : 每 当 你 在 搜索 框 中 输入 字符 时 , 浏览 器 或 网 页 都 会 调用 服务 器 ,看 看 有 哪 
些 以 你 输入 的 字母 打头 的 内 容 。 因 此 ， 当 你 输入 a 时 ,将 返回 一 些 以 a 打头 的 短语 。 当 你 接着 叉 输 
入 n 时 ， 将 返回 一 些 以 an 打头 的 短语 。 依 此 类 推 。 

在 服务 器 内 部 ,进行 了 一 些 非 常 聪明 的 处 理 。 它 知道 你 是 谁 、 身 处 何方 ,以 及 最 近 搜索 了 什 
么 ,因此 能 够 为 你 定制 结果 。 请 尝试 做 个 这 样 的 实验 : 与 朋友 一 起 将 各 自 的 计算 机 并 排放 置 ， 并 
访问 同一 个 搜索 网 站 。 然 后 ,以 每 次 一 个 字母 的 方式 输入 相同 的 短语 ,并 比较 你 们 得 到 的 建议 一 一 
建议 很 可 能 截然 不 同 。 按 下 回 车 键 后 ， 最 终 返 回 的 结果 也 将 不 同 "。 

































































11.2 Suggest 示例 


下 面 来 创建 一 个 程序 , 它 调 用 Web 服 务 Suggest 并 显示 结果 , 就 像 搜索 引擎 或 智能 地 址 栏 一 样 。 
要 使 用 这 个 程序 ， 只 需 输入 一 个 短语 即 可 。 在 你 输入 时 ， 这 个 程序 将 使 用 Web 服 务 Suggest 获 取 补 
全 建议 ， 如 图 11-1 所 示 。 
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GD 有 关 这 种 现象 的 更 详细 信息 ， 请 参阅 http:/en.wikipedia.org/wiki/Filter bubble。 
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为 创建 这 个 应 用 ， 首 先 使 用 如 下 设置 新 建 一 个 项 目 。 


口 应 用 名 : Suggest 

口 公司 域名 : example.org 

口 尺寸 : Phone and Tablet 

口 最 低 SDK: API 16: Android 4.1 ( Jelly Bean ) 
口 添加 活动 : Blank Activity 

口 活动 名 : MainActivity 
口 布局 名 : activity_main 
口 标题 : Suggest 


由 于 这 个 示例 要 访问 Internet 以 调用 Web 服 务 ， 因 此 需要 让 Android 授 予 我 们 这 种 权限 。 
为 此 ， 在 文件 AndroidManifest.xml 中 ， 在 XML 标 签 <application> 前 面 添 加 如 下 一 行 。 

















suggest/src/main/AndroidManifest.xml 


<uses-permission android:name="android.permission.INTERNET" /> 


主 活动 的 布局 非常 简单 ， 为 一 个 包含 多 行 的 垂直 LinearLayout。 











suggest/src/main/res/layout/activity_main.xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="vertical" 
android:padding="10dip" > 


<TextView 
android:Layout width="fill parent" 
android:layout height="wrap content" 
android:text="@string/original label" /> 


<EditText 
android:id="@+id/original text" 
android:layout width="fill parent" 
android:layout height="wrap_ content" 
android:hint="@string/original hint" 
android:inputType="textNoSuggestions" 
android:padding="10dip" 
android:textSize="18sp" /> 


<TextView 
android:layout width="fill parent" 
android:layout height="wrap_ content" 
android:text="@string/result label" /> 


<ListView 
android:id="@+id/result list" 
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android:Layout width="fill parent" 
android:layout height="0Qdp" 
android:layout weight="1" /> 


<TextView 
android:id="@+tid/eband_ text" 
android:layout width="fill parent" 
android:layout height="wrap_content" 
android:gravity="bottom|right" 
android:text="@string/eband" /> 


</LinearLayout> 


在 这 个 示例 中 ， 包 含 5 行 。 第 1 行 是 一 个 标签 ， 让 用 户 在 第 2 行 (一 个 文本 框 ) 中 输入 要 搜索 
的 内 容 。 第 3 行 是 另 一 个 标签 ， 后 面 是 建议 列表 。 我 要 将 这 个 示例 发 布 到 Google Play Store， 因 此 
最 后 一 行 是 为 本 书 做 的 一 个 小 广告 。 


下 面 来 修改 MainActivity 类 ， 其 基本 轮廓 如 下 。 












































suggest/src/main/java/org/example/suggest/MainActivity.java 


Line1 package org.example.suggest; 


- import java.util.ArrayList; 

- import java.util.List; 

5 import java.util.concurrent.ExecutorService; 

- import java.util.concurrent.Executors; 

- import java.util.concurrent.Future; 

- import java.util.concurrent.RejectedExecutionException; 


10 import android.app.Activity; 
- import android.app.SearchManager; 
- import android.content.Intent; 
- import android.os.Bundle; 
- import android.os.Handler; 
15 import android.text.Editable; 
- import android.text.TextWatcher; 
- import android.text.method.LinkMovementMethod; 
- import android.view.View; 
- import android.widget.AdapterView; 
20 import android.widget.AdapterView.OnItemClickListener; 
- import android.widget.ArrayAdapter; 
- import android.widget.EditText; 
- import android.widget.ListView; 
- import android.widget.TextView; 





2) 
- public class MainActivity extends Activity { 
- private EditText origText; 
- private ListView suggList; 
- private TextView ebandText; 
30 


- private Handler guiThread ; 
- private ExecutorService suggThread ; 
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private Runnable updateTask; 
private Future<?> suggPending; 
35 private List<String> items; 
private ArrayAdapter<String> adapter; 


@Override 
- public void onCreate(Bundle savedInstanceState) { 
40 super.onCreate(savedInstanceState); 


setContentView(R.layout.activity main); 
initThreading(); 
findViews(); 
45 setListeners(); 
setAdapters(); 


和 
声明 几 个 变量 后 ， 从 第 39 行 开始 定义 了 方法 onCreate() ， 它 负责 初始 化 线程 和 用 户 界面 。 
请 别 担心 ， 后 面 将 编写 它 调用 的 所 有 方法 。 


第 44 行 调用 的 方法 findViews () 用 来 获取 句柄 , 它们 分 别 指向 布局 文件 定义 的 各 个 用 户 界面 
元 素 。 





























suggest/src/main/java/org/example/suggest/MainActivity.java 

private void findViews() { 
origText = (EditText) findViewById(R.id.original text); 
suggList = (ListView) findViewById(R.id.resuLt List) ; 
ebandText = (TextView) findViewById(R.id.eband text); 

} 


在 方法 onCreate() 中 ， 第 46 行 调用 的 方法 setAdapters() 负 责 为 列表 视图 定义 数据 源 。 





suggest/src/main/java/org/example/suggest/MainActivity.java 
/** 设置 列表 视图 的 适配器 */ 
private void setAdapters() { 
items = new ArrayList<String>(); 
adapter = new ArrayAdapter<String>(this, 
android.R.layout.simple list item 1, items); 
suggList.setAdapter(adapter); 
} 


在 Android 中 ，Adapter 是 一 个 将 数据 源 ( 这 里 是 建议 列表 ) 绑 定 到 用 户 界面 控件 ( 这 里 是 一 
个 ListView ) 的 类 。 对 于 每 个 列表 项 ， 都 使 用 Android 提 供 的 标准 布局 。 

接 下 来 ,在 方法 setListeners() 中 (在 方法 onCreate() 中 ,这 是 在 第 45 行 调用 的 ) 设置 用 
户 界面 处 理 程序 。 
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suggest/src/main/java/org/example/suggest/MainActivity.java 


private void setListeners() { 
// 定义 文本 变化 监听 器 
= new TextWatcher() { 


TextWatcher textWatcher 
public void beforeTextChanged(CharSequence s, int start, 
int count, int after) { 
/* 什么 都 不 做 */ 
} 
public void onTextChanged(CharSequence s, int start, 
int before, int count) { 
queueUpdate(1000 /* 毫秒 数 */); 
} 
public void afterTextChanged(Editable s) { 
/* 什么 都 不 做 */ 
} 
}; 


// 给 搜索 框 指 定 监听 器 
origText.addTextChangedListener (textWatcher); 


// 定义 列表 项 点 击 监听 器 

OnItemClickListener clickListener = new OnItemClickListener() { 
@Override 

public void onItemClick(AdapterView<?> parent, View view, 


int position, long id) { 
String query = (String) parent.getItemAtPosition(position); 


doSearch(query); 
}; 
// 给 建议 列表 指定 监听 器 
suggList.setOnItemClickListener(clickListener); 


// 将 网 站 链接 设置 成 可 点 击 的 
ebandText ,setMovementMethod(LinkMovementMethod .getInstance() ) ; 


} 


private void doSearch(String query) { 
Intent intent = new Intent(Intent.ACTION WEB SEARCH); 


intent.putExtra(SearchManager.QUERY, query); 





startActivity(intent); 


} 
这 里 定义 了 两 个 监听 器 : 一 个 在 输入 文本 框 的 内 容 发 生变 化 时 被 调用 , 另 一 个 在 用 户 点 击 建 
议 时 被 调用 。 方法 queueUpdate() 使 用 HandtLer 将 一 个 延迟 更 新 请 求 加 入 到 主线 程 的 待 办 事项 列 





表 中 ， 这 里 随意 地 将 文本 变化 延迟 设置 成 了 1000 毫 秒 。 
在 方法 setListeners() 的 最 后 ,对 广告 视图 调用 了 方法 setMovementMethod(), 将 广告 文 
本 转换 成 了 超 链 接 。 这 样 ， 在 用 户 点 击 该 链接 时 ， 将 打开 一 个 浏览 器 窗口 ， 并 在 其 中 显示 指定 地 











址 处 的 网 页 。 


重 版 权 
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11.3 ”穿针引线 


Line 1 


5 


20 


23 


30 


小 
我 们 有 两 个 线程 : 用 于 用 户 界 面 的 主 Android 线 程 和 用 于 执行 实际 建议 作业 的 建议 线程 。 
第 一 个 线程 由 一 个 Android Handler 表 示 ， 第 二 个 线程 由 Java ExecutorService 表 示 。 

第 6 行 定义 了 将 由 方法 queueUpdate( ) 调度 的 更 新 任务 。 这 个 任务 在 运行 时 ， 首 先 会 获取 当 


中 ， 








更 新 请 求 是 在 方法 initThreading() 中 定义 的 。 


suggest/src/main/java/org/example/suggest/MainActivity.java 
private void initThreading() { 

guiThread = new Handler(); 

suggThread = Executors.newSingleThreadExecutor(); 


// 这 个 任务 要 求 获取 建议 并 更 新 屏幕 
updateTask = new Runnable() { 
public void run() { 
// 获取 搜索 文本 
String original = origText.getText().toString().trim(); 


// 撤销 以 前 的 建议 (如果 有 的 话 ) 
if (suggPending != null) 
suggPending.cancel (true); 


// 确认 输入 了 搜索 文本 

if (original.length() != 0) { 
// 让 用 户 知道 程序 正在 执行 操作 
setText(R.string.working); 


// 开始 获取 建议 ， 但 不 等 待 结果 
try { 

SuggestTask suggestTask = new SuggestTask( 
MainActivity.this，// 指向 当前 活动 的 引用 
original // 搜索 文本 

); 

suggPending = suggThread.submit(suggestTask); 

} catch (RejectedExecutionException e) { 

// 无 法 开始 新 任务 

setText(R.string.error); 


} 
}; 











其 


-~ 


前 的 搜索 文本 ,然后 准备 好 将 建议 作业 发 送 给 建议 线程 。 撤 销 还 未 完成 的 建议 作业 (第 13 行 )， 


确认 用 户 输入 了 搜索 文本 (第 16 行 )， 并 在 建议 列表 中 显示 字符 串 Working (第 18 行 )。 后面 将 把 








该 文本 替换 为 实际 建议 。 


最 后 ， 第 22 行 将 创建 一 个 SuggestTask 实 例 。 我 们 给 它 提 供 了 指向 主 活动 的 引 月 
修改 建议 列表 ,我 们 还 提供 了 一 个 包含 搜索 文本 的 字符 串 。 第 26 行 将 这 个 新 任务 提交 给 建议 线 和 和 
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这 将 返回 一 个 引用 ， 它 指向 最 终 以 Future 的 方式 返回 的 值 。 在 这 个 示例 中 ， 实 际 上 并 不 需要 返 
回 值 , 因为 SuggestTask 直 接 修 改 了 GUI, 但 前 面 的 第 13 行 使 用 了 这 个 Future 引 用 来 撤销 未 完成 
的 建议 获取 作业 。 








1 小 乔 爱问 : 
过 “有 必要 使 用 延迟 和 线程 技术 吗 ? 


这 样 做 的 目的 之 一 是 避免 过 多 地 调用 外 部 Web 服务 。 想 象 一 下 用 户 在 输入 单词 scissors 
时 发 生 的 情况 吧 。 在 这 个 程序 看 来 ， 这 个 单词 是 以 每 次 一 个 字符 的 方式 输入 的 。 首 先是 S， 
然后 依次 为 c、i 等 ， 还 可 能 有 退 格 ， 因 为 用 户 可 能 忘记 了 这 个 单词 是 如 何 拼写 的 。 你 希望 
用 户 每 输入 一 个 字符 就 发 起 一 次 Web 服务 请 求 吗 ? 当然 不 希望 。 这 样 做 除了 会 给 服务 器 增 
加 不 必要 的 负担 外 ,还 会 浪费 电量 。 每 次 请 求 时 ， 设 备 的 无 线 设 备 都 得 发 送 和 接收 多 个 数据 
包 ， 这 将 耗 党 一 定 的 电量 。 你 会 希望 等 到 用 户 输入 完毕 后 再 发 送 请 求 ， 但 如 何 判断 用 户 输入 
完毕 了 呢 ? 


这 里 使 用 的 算法 是 ， 用户 每 输入 一 个 字符 ,就 发 起 一 个 延迟 的 请 求 。 如 果 延 迟 1 秒 后 用 
户 还 没有 输入 另 一 个 字符 ,请 求 将 发 送出 去 ; 否则 就 将 前 一 个 请 求 从 请 求 队列 中 删除 。 如 果 
请 求 已 发 出 ， 但 还 未 完成 ， 就 尝试 中 断 它 。 好 消息 是 ， 经 过 我 的 示范 后 ， 你 可 以 将 这 种 技巧 
用 于 自己 的 异步 程序 中 。 


11.4 “” 细 枝 末节 


在 Suggest 示 例 中 ， 还 包含 其 他 一 些 工具 函数 ， 如 下 所 示 。 











suggest/src/main/java/org/example/suggest/MainActivity.java 
/** 请 求 短 暂 延 迟 后 进行 更 新 */ 
private void queueUpdate(Long delayMillis) { 
// 撤销 以 前 的 更 新 (如 果 它 还 没有 开始 ) 
guiThread.removeCallbacks (updateTask); 
// 如 果 几 毫秒 后 什么 都 没有 发 生 ， 就 开始 更 新 
guiThread.postDelayed(updateTask, delayMillis); 
} 





/** 修改 屏 莫 上 的 建议 列表 (从 另 一 个 线程 中 调用 ) */ 

public void setSuggestions(List<String> suggestions) { 
guiSetList(suggList, suggestions); 

} 


/** 对 GUI 的 所 有 修改 都 必须 在 GUI 线程 中 进行 */ 


private void guiSetList(finaL ListView view, 
final List<String> list) { 
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guiThread.post(new Runnable() { 
public void run() { 
setList(list); 
} 


}); 
} 


/# 灶 显示 一 条 消息 */ 

private void setText(int id) { 
adapter.clear(); 
adapter.add(getResources().getString(id)); 

下 


/** 显示 建议 列表 */ 

private void setList(List<String> list) { 
adapter.cLear() 
adapter.addAll (list); 

} 


queueUpdate() 负 责 将 一 个 更 新 请 求 加 入 主线 程 的 请 求 队列 中 , 但 要 求 等 待 一 段 时 间 后 再 运 
行 它 。 如 果 队 列 中 已 经 有 请 求 存 在 ， 就 将 其 删除 。 

Web 服 务 返回 结果 后 ，SuggestTask 将 使 用 方法 setSuggestions () 来 更 新 用 户 界 面 。 这 个 
方法 调用 了 私有 方法 guiSetList(), 后 者 又 会 调用 方法 HandLer,post () 请 求 主 GUI 线程 更 新 列 
表 视 图 。 这 一 步 必 不 可 少 , 因为 你 不 能 在 非 用 户 界 面 线程 中 调用 用 户 界 面 函数 , 而 guiSetList() 
是 在 建议 线程 中 被 调用 的 。 

最 后 ， 由 setText() 和 setList() 更 新 适配器 ,使 其 包含 单个 字符 串 或 一 个 字符 串 列表 。 

下 面 是 Suggest 示 例 中 的 文件 res/values/strings.xml， 它 定义 了 该 程序 使 用 的 字符 串 资源 。 



















































































suggest/src/main/res/values/strings.xml 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 


<string name="app_name">Suggest</string> 
<string name="action settings">Settings</string> 
<string name="original hint">Enter partial text</string> 
<string name="original label">0riginal text:</string> 
<string name="result label">Suggestions:</string> 
<string name="working">Working...</string> 
<string name="error">(Web service error)</string> 
<string name="interrupted">(Web service interrupted)</string> 
<string name="no results">(No suggestions)</string> 
<string name="eband">Example from 
<a href="http://pragprog.com/book/eband4">Hello, Android</a> 
by Ed Burnette</string> 


</resources> 


到 现在 还 没有 介绍 的 只 有 SuggestTask 类 了 ， 它 负责 在 后 台 调 用 Web 服 务 。 
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11.5 建议 获取 任务 


最 后 ，SuggestTask 的 定义 如 下 。 


suggest/src/main/java/org/example/suggest/SuggestTask.java 


package org.example.suggest; 


import java.io.I0Exception; 

import java.net.HttpURLConnection; 
import java.net.URL; 

import java.net.URLEncoder; 

import java.util.LinkedList; 
import java.util.List; 


import org.xmlpull.v1.XmlPullParser; 
import org.xmlpull.v1.XmlPullParserException; 


import android.util.Log; 
import android.util.Xml; 


public class SuggestTask implements Runnable { 
private static final String TAG = "SuggestTask"; 
private final MainActivity suggest; 
private final String original; 


SuggestTask(MainActivity context, String original) { 
this.suggest = context; 
this.original = original; 


} 


public void run() { 
// 获取 针对 搜索 文本 的 建议 
List<String> suggestions = doSuggest(original); 
suggest.setSuggestions(suggestions); 


调用 Go0gle Suggest API， 根 据 搜索 文本 创建 一 个 建议 列表 


http://ff.search.yahoo.com/gossip?output=xml&command=WORD 或 
http://ff.search.yahoo.com/gossip?output=fxjson&command=WORD 
34 
private List<String> doSuggest(String original) { 
List<String> messages = new LinkedList<String>(); 
String error = null; 
HttpURLConnection con = null; 
Log.d(TAG, "doSuggest(" + original + ")"); 


* 
* 
* 注意 ; 这 个 API 可 能 木 得 到 支持 。 如 果 它 不 管用 ， 请 尝试 使 用 Yahoo 提 供 的 API 
* 
* 
* 





try { 
// 检查 任务 是 否 被 中 断 
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if (Thread.interrupted()) 
throw new InterruptedException(); 


// 创建 针对 GoogLe API 的 RESTful 查 询 

String q = URLEncoder.encode(original, "UTF-8"); 

URL url = new URL( 
"http://google.com/complete/search?output=toolbar&q=" 

+ q); 

con = (HttpURLConnection) url.openConnection(); 

con.setReadTimeout(10000 /* 毫秒 数 */); 

con.setConnectTimeout(15000 /* 毫秒 数 */); 

con.setRequestMethod("GET"); 

con.addRequestProperty("Referer", 
"http://www.pragprog.com/book/eband4"); 

con.setDoInput (true); 


// 启动 查询 
con.connect (); 


// 检查 任务 是 否 被 中 断 
if (Thread.interrupted()) 
throw new InterruptedException(); 


// 提取 查询 结果 
XmlPullParser parser = Xml.newPullParser(); 
parser.setInput(con.getInputStream(), null); 
int eventType = parser.getEventType(); 
while (eventType != XmlPullParser.END DOCUMENT) { 
String name = parser.getName(); 
if (eventType == XmlPullParser.START TAG 
&& name.equalsIgnoreCase("suggestion")) { 
for (int i = 0; i < parser.getAttributeCount(); i++) { 
if (parser.getAttributeName(i).equaLsIgnoreCase( 
"data")) { 
messages.add(parser.getAttributeValue(i)); 


} 


eventType = parser.next(); 


// 检查 任务 是 否 被 中 断 
if (Thread.interrupted()) 
throw new InterruptedException(); 


} catch (IOException e) { 
Log.e(TAG, "IOException", e); 
error = suggest.getResources().getString(R.string.error) 
+" "+e.toString(); 
} catch (XmlPullParserException e) { 
Log.e(TAG, "XmlPullParserException", e); 
error = suggest.getResources().getString(R.string.error) 
+" "+e.toString(); 
} catch (InterruptedException e) { 
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Log.d(TAG, "InterruptedException", e); 
error = suggest.getResources().getString( 
R.string.interrupted); 
} finally { 
if (con != null) { 
con.disconnect(); 
} 
} 


// 如 果 发 生 了 错误 ， 就 返回 错误 本 身 

if (error != nuLL) { 
messages.clear(); 
messages.add(error) 


// 指出 没有 查询 结果 
if (messages.size() == 0) { 
messages.add(suggest.getResources().getString( 
R.string.no_ results)); 


} 


// 处 理 完毕 
Log.d(TAG, " -> returned " + messages); 
return messages; 
} 
} 





这 是 一 个 很 不 错 的 示例 ， 它 使 用 HttpURLConnection 调 用 了 一 个 RESTful Web 服 务 ， 来 对 


JSON ( JavaScript Object Notation ) 格式 的 结果 进行 分 析 ， 并 处 型 





了 各 种 网 络 错误 和 中 断 请 求 。 


这 里 不 打算 详细 阐述 它 ， 因 为 除了 几 条 调试 消息 外 ， 其 他 代码 都 不 是 Android 特 有 的 。 


至 此 ，Suggest 示 例 就 编写 完成 了 。 请 尝试 运行 一 下 , 看 看 Google 会 认为 你 要 搜索 什么 有 趣 的 
东西 。 只 要 进行 简单 的 搜索 ， 你 就 可 以 在 网 上 找到 更 多 有 趣 的 搜索 建议 。 
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本 章 介 绍 了 如 何 使 用 异步 Web 服 务 。 如 果 你 要 使 用 ExecutorService 等 类 进行 大 量 的 并 发 编 











程 ， 建 议 阅读 Brian Goetz 编 著 的 《JAVA 并 发 编程 实战 》( Java Concurrency in Practice ) [Goe06]。 


创建 Web 服 务 不 在 本 书 的 讨论 范围 之 内 ,但 最 简单 的 方法 之 一 是 使 用 Google App Engine 
(GAE ) ”， 它 能 够 让 你 在 云端 托管 使 用 各 种 语言 (如 Java、Python 和 PHP ) 编写 的 后 端 服务 。 


后 面 的 章节 将 带领 你 探索 如 何 使 用 触摸 事件 和 Google 服 务 提供 男 一 种 交互 。 如 果 你 急于 更 深 





和 人 地 了 解数 据 源 和 数据 绑 定 ， 可 直接 跳 到 第 13 章 。 其 中 介绍 了 另 一 
使 用 Loader 类 。 











CD http://developers.google.com/appengine/ 
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使 用 Google Play 服务 








Google Play 服务 是 Android 框 架 的 一 个 搬 件 , 可 以 在 任何 使 用 Google Play Store 的 Android 设 备 


中 找到 。 








Google Play 服务 最 初 默默 无 闻 ， 只 是 用 来 访问 Google 授 权 和 社交 网 络 Google+ 的 一 种 方式 ， 


然而 现在 却 已 经 拥有 了 大 量 的 功能 ， 其 中 很 多 最 初 都 包含 在 Android 框 架 中 。 这 些 功能 包括 : 


口 位 置 服 务 
口 游戏 服务 
口 应 用 内 购买 
口 广告 


口 地 图 

口 推送 消息 
口 云 存储 
口 其 他 














口 移动 分 析 ( Mobile analytics ) 


在 应 用 中 包含 、 配 置 和 调用 所 有 Google Play 服务 的 方式 都 相似 。 因 此 只 要 学 习 一 种 服务 ,学 
会 使 用 所 有 服务 的 任务 便 完 成 了 一 半 。 

本 章 将 以 位 置 服务 API 为 例 简 要 地 介绍 Google Play 服务 。 阅 读 完 本 章 后 ， 你 将 了 解 如 何在 应 
用 中 包含 Google Play 服务 ， 如 何 检测 它 是 否 可 用 ， 如 何 调用 它 ， 以 及 如 何 处 理发 生 的 各 种 错误 。 








12.1 工作 原理 
在 你 的 应 用 中 包含 一 个 小 























型 客户 端 库 ， 它 负责 与 Google Play 服务 APK ( 应 用 包 ) 通信 。 当 你 











执行 调用 时 ， 小 型 客户 端 库 会 


向 服务 发 送 一 条 消息 ， 而 服务 将 以 你 的 名 义 执 行 指定 的 操作 。 


每 个 应 用 都 与 同一 个 服务 APK 通 信 ( 如 图 12-1 所 示 ), 该 APK 会 通过 Google Play Store 频 繁 地 进 
行 更 新 。 这 种 设计 能 够 让 Google 将 修复 补丁 和 新 功能 直接 推送 到 你 的 手机 或 平板 电脑 ， 而 无 需 等 
待 Android 系 统 更 新 和 运营 商 批准 。 这 还 可 以 节省 空间 , 因为 不 要 求 每 个 应 用 重复 包含 相同 的 代码 。 
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Google Play 


图 12-1 








在 Google Play 服务 提供 的 功能 中 ， 最 常用 的 一 个 是 位 置 服务 。 下 面 深入 介绍 其 用 途 和 用 法 。 


12.2 ”使 用 位 置 服务 

几乎 每 部 手机 都 装备 了 GPS 和 加 速 计 芯片 等 传感器 , 这 打开 了 通 向 位 置 和 环境 识别 移动 计算 
的 大 门 。 宽 带 移动 网 络 日 益 普及 , 计算 和 存储 能 力 呈 几何 级 数 增长 ,， 这些 都 给 人 类 彼此 交互 科 人 
机 交互 的 方式 带 来 了 革命 性 改变 。 






































Android 框 架 提 供 了 大 量 可 用 于 在 应 用 中 集成 传感器 数据 的 API， 包 括 从 GPS 、 基 站 和 Wi-Fi 
获取 位 置信 息 的 低级 API。 解 读 所 有 这 些 数据 并 不 容易 ， 但 位 置 服 务 API 可 助 你 一 臂 之 力 。 位 置 
服务 提供 了 一 个 强大 的 高 级 框架 , 所 有 应 用 都 可 使 用 它 来 获得 可 靠 的 位 置 数据 ,同时 减少 消耗 的 





电量 。 


位 置 服务 最 初 是 一 个 自 定义 库 ， 仅 供 

















Google Maps 和 其 他 专用 应 用 使 用 。 通 过 将 其 加 入 到 




















Google Play 服务 中 ，Google 能 够 让 你 在 自己 的 应 用 中 使 用 该 技术 。 当 前 ，Google 建 议 编写 新 代码 



































时 都 使 用 位 置 服务 。 

为 演示 位 置 服务 ， 我 们 将 创建 一 个 应 用 ， 它 显示 随时 间 推 移 而 不 断 变化 的 当前 位 置 。 图 12-2 
是 这 个 项 目的 屏幕 截图 。 

这 个 应 用 首先 显示 设备 的 初始 位 置 ， 然 后 频繁 地 更 新 屏幕 ,不 断 显示 最 新 的 位 置 。 如 果 你 坐 
着 不 动 ， 就 看 不 出 它 的 优势 。 这 是 一 个 适合 带 着 去 散步 的 应 用 。 
































图 12-2 中 的 各 个 数字 都 是 什么 意思 呢 ? 第 一 栏 的 数字 是 相 邻 两 行 的 打印 间隔 , 接 下 来 是 以 字 
符 串 方式 打印 的 位 置 。 这 些 字符 串 的 格式 是 使 用 方法 Location.toString() 设 置 的 。 
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9 


1 。 
| Location Test 





+0009: Google Play services is available 

+0091: Connected 

+0003: Locations (starting with last known): 

+0003: Location[fused 35.773867,-78.837704 acc=96 et=+45d2h32m7s521ms alt=98.0999984741211] 


+0092: Location| 


fused 35.773867,-78.837704 acc=96 et=+45d2h32m9s255ms alt=98.0999984741211] 


+5064: Location[fused 35.773867,-78.837704 acc=96 et=+45d2h32m14s297ms alt=98.0999984741211 


+4229: Location| 


fused 35.773867,-78.837704 acc=21 et=+45d2h32m18s544ms alt=98.0999984741211 


+5140: Location[fused 35.773867,-78.837704 acc=25 et=+45d2h32m23s519ms alt=98.0999984741211 
+4850: Location[fused 35.773867,-78.837704 acc=96 et=+45d2h32m28s536ms alt=98.0999984741211 


+4002: Location| 
+1937: Location| 
+2032: Location 


fused 35.773867,-78.837704 acc=96 et=+45d2h32m32s538ms alt=98.0999984741211 
fused 35.773867,-78.837704 acc=96 et=+45d2h32m34s480ms alt=98.0999984741211 
fused 35.773867,-78.837704 acc=96 et=+45d2h32m36s517ms alt=98.0999984741211 


+3004: Location[fused 35.773867,-78.837704 acc=96 et=+45d2h32m39s515ms alt=98.0999984741211 


+3487: Location| 
+1548: Location 
+1959: Location| 
+3016: Location| 
+2986: Location| 














在 Java 编 程 中 ， 一 种 常见 的 做 法 是 ， 为 每 个 主要 类 都 定义 方法 toString() 
试 期 间 轻 松 地 打印 它们 。Location 类 的 实例 以 如 下 格式 进行 打印 。 




















Location[<provider-type 


fused 35.773867,-78.837704 acc=96 et=+45d2h32m42s521ms alt=98.0999984741211 


fused 35.773867,-78.837704 acc=96 et=+45d2h32m44s544ms alt=98.0999984741211 
fused 35.773867,-78.837704 acc=96 et=+45d2h32m46s517ms alt=98.0999984741211 
fused 35.773867,-78.837704 acc=96 et=+45d2h32m49s528ms alt=98.0999984741211 
fused 35.773867,-78.837704 acc=96 et=+45d2h32m52s521ms alt=98.0999984741211 











> <longitude>, <latitude>, acc=<accuracy>] 


其 中 各 项 内 容 的 含义 如 下 。 
口 provider-type: 计算 位 置 的 硬件 或 软件 提供 器 。Fused 提 供 器 是 一 球 智能 软件 ， 它 结合 








地 减少 耗 电量 。 
DD longitude 和 1latit 











使 用 各 种 硬件 提供 器 〈 Wi-Fi、 基 站 等 




















ude: 在 地 球 上 的 当前 位 置 。 


























这 样 可 以 在 调 








) 提供 的 位 置 来 获得 最 准确 的 位 置 ， 同 时 最 大 限度 


D accuracy: 系统 测量 位 置 的 准确 度 。 例 如 ， 基 站 定位 很 不 准确 ， 如 果 系 统 使 用 的 是 这 种 
方式 ， 相 应 的 数字 将 很 大 。 





你 还 可 能 看 到 其 他 信息 〈 如 果 这 些 信息 可 用 )， 如 过 去 了 多 长 时 间 、 海 拔 、 航 向 和 速度 。 


12.2.1 起 步 





说 得 够 多 了 ， 现 在 开始 
应 用 名 : Location Test 


口 公司 域名 : example. 








口 活动 名 : MainActivi 














Ce 





编码 吧 ! 使 用 如 下 设置 新 建 一 个 应 用 。 


org 


口 尺寸 : Phone and Tablet 
口 最 低 SDK: API 16: Android 4.1 (Jelly Bean ) 
口 添加 活动 : Blank Activity 


ty 
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口 布局 名 : activity_main 
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口 标题 : LocationTest 
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设置 使 用 Google Play 服务 的 项 目 时 ， 相 比 于 普通 Andriod 应 用 ， 这 里 需要 执行 两 三 个 额外 的 
步骤。 首先 , 需要 修改 编译 脚本 , 在 其 中 添加 对 Google Play 服 务 客户 端 库 的 编译 阶段 依 划 
打开 app 模 块 ( 而 不 是 Project:LocationTest 模 块 ) 的 build.gradle 文 件 , 在 dependencies 下 新 增 一 条 





负 。 为 此 ， 
使 用 最 新 版 play- services 的 编译 规则 ， 如 下 所 示 。 


locationTest/build.gradle 
i 


dependencies { 





compile fileTree(dir: 'libs', include: ['*.jar']) 
compile 'com,.android.support:appcompat-v7:22+' 
compile 'com.google.android.gms:play-services:7.+' 
} 





files have changed since last project sync )。 单 击 Sync Now 链 接 重 新 编 
第 二 个 额外 的 步 又 是 
并 


RAE , 














在 窗口 顶部 将 出 现 一 条 警告 消息 ， 指 出 最 后 一 次 项 目 同步 后 Gradle 文 件 发 生 了 变化 ( Gradle 











译 项 目 。 
需要 在 清单 文件 中 添加 一 项 信息 。 为 此 ， 打 开 文 件 AndroidManifestxml， 
在 appLication 标 签 下 添加 如 下 标签 


locationTest/src/main/AndroidManifest.xml 
<meta-data 


android:name="com. google.android.gms.version" 


android:value="@integer/google play services version" /> 
如 玉 


要 使 用 ProGuard ( 一 个 应 用 优化 和 代码 混淆 工具 ) 
例 都 没有 使 用 它 , 但 如 果 你 的 应 月 




















还 需 执行 一 个 额外 步 又。 本 书 的 示 
使 用 到 了 ， 还 必须 编辑 文件 proguard-project.txt， 以 防 ProGuard 
剥离 必 不 可 少 的 类 。 有 关 这 方面 的 详情 ， 请 参阅 在 线 文档 ”。 

设置 好 项 目 后 ， 下 面 来 处 理 用 户 界面 。 


12.2.2 ”创建 用 户 宽 面 




















主 活动 包含 一 个 可 滚动 的 文本 视 网 ， 它 覆盖 了 整个 





屏幕 。 日 志 输 出 将 被 添加 到 末尾 ， 填 满 后 
文本 将 向 上 滚动 。 请 编辑 布局 文件 activity_main.xml, 在 其 中 定义 一 个 id 为 scroLLer 的 ScrollView， 
它 包 含 一 个 id 为 output 的 TextView。 


locationTest/src/main/res/layout/activity_main.xml 


<?xml version="1.0" encoding="utf-8"?> 
<ScrollView 





xmlns:android="http://schemas.android.com/apk/res/android" 


QD http://d.android.com/google/play-services/setup.html 
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xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/scroller" 

android:layout width="match parent" 

android:layout height="match parent" 
android:paddingLeft="@dimen/activity horizontal margin" 
android:paddingRight="@dimen/activity horizontal margin" 
android:paddingTop="@dimen/activity vertical margin" 
android:paddingBottom="@dimen/activity vertical margin" 
tools:context=" .MainActivity"> 


<TextView 
android:id="@+id/output" 
android:layout width="match parent" 
android:layout height="match parent" 
android:textSize="16sp" /> 
</ScrollView> 


将 文本 大 小 设置 为 16sp， 让 文本 更 容易 识别 。 
接 下 来 ， 打 开 文 件 MainActivity， 并 创建 如 下 轮廓 。 





locationTest/src/main/java/org/example/locationtest/MainActivity.java 


package org.example.locationtest; 


import android.app.Activity; 
import android.app.Dialog; 

import android.content.Intent; 
import android.content.IntentSender; 
import android.Location.Location; 
import android.os.Bundle; 

import android.view.Menu ; 

import android.view.MenuItem; 
import android.view.View; 

import android.widget.ScrollView; 
import android.widget.TextView; 


import com.google.android.gms.common.ConnectionResult; 
import com.google.android.gms.common.GooglePlayServicesUtil; 
import com.google.android.gms.common.api.GoogleApiClient; 
import com.google.android.gms.location.LocationListener; 
import com.google.android.gms.location.LocationRequest; 
import com.google.android.gms.location.LocationServices; 


public class MainActivity extends Activity impLements 
GoogleApiClient.ConnectionCallbacks, 
GoogleApiClient.OnConnectionFailedListener, 
LocationListener { 
private static final long UPDATE INTERVAL = 5000; 
private static final Long FASTEST INTERVAL = 1000; 
private static final int CONNECTION FAILURE RESOLUTION REQUEST 


private TextView mOutput; 
private ScrollView mScroller; 
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private GoogleApiClient mGoogleApiClient; 
private long mLastTime; 
Ls 
35 } 
从 第 3 行 开 始 ， 是 这 个 类 需要 的 所 有 import 语 句 。 如 果 是 手动 输入 这 个 示例 的 代码 ， 可 以 不 
输入 这 些 ijmport 语 句 ， 而 让 Android Studio 自 动 添加 它们 ， 即 在 每 个 未 定义 引用 处 单 击 鼠 标 ， 再 
按 Alt 和 回 车 键 。 


MainActivity 类 始 于 第 22 行 。 它 继承 了 Activity 类 , 并 实现 了 两 个 接口 : ConnectionCallbacks 
和 0nConnectionFailedListener。 实现 接口 是 为 了 告诉 编译 器 , 我 们 将 添加 这 些 接口 定义 的 必 
要 方法 。 添 加 这 些 方法 前 ， 编 辑 器 窗口 中 始终 有 错误 标记 。 


在 MainActivity 中 ， 我 们 声明 了 一 些 后 面 需要 的 常量 和 变量 。 
有 了 基本 轮廓 后 ， 来 编写 缺失 的 方法 。 第 一 个 是 活动 启动 前 调用 的 方法 onCreate() 。 





























locationTest/src/main/java/org/example/locationtest/MainActivity.java 
Line 1 @Override 
- public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
SetContentView(R.Layout.activity main); 


// 定义 前 述 API 客 户 端 

mGoogleApiClient = new GoogleApiClient.Builder(this) 
.addConnectionCallbacks (this) 
.addOnConnectionFailedListener(this) 

10 .addApi (LocationServices.API) 

.build(); 


// 获取 指向 视图 的 引用 
- mOutput = (TextView) findViewById(R.id.output); 
15 mScroller = (ScrollView) findViewById(R.id.scroller); 


// 获取 当前 时 间 ， 以 便 获 悉 更 新 之 后 的 时 间 
- mLastTime = System.currentTimeMillis(); 
> 

首先 使 用 根据 布局 XML 生成 的 视图 填充 活动 ， 如 第 4 行 所 示 。 第 7 行 用 于 新 建 一 个 
GoogtLeApiCLient (Google Play 服务 中 的 一 个 类 ) 实例 ， 后 面 将 连接 到 这 个 实例 来 获取 位 置 。 

第 14~15 行 调用 findViewById() 获 取 指 向 布局 中 两 个 视图 的 句柄 。 最后, 第 18 行 获取 当前 的 
系统 时 间 ， 以 便 计 算 打 印 每 行 日 志 时 过 去 了 多 少时 间 。 

下 面 的 两 个 方法 是 Blank Activity 模 板 添加 的 。 



































locationTest/src/main/java/org/example/locationtest/MainActivity.java 
Line 1 @Override 
- pubLic boolean onCreate0ptionsMenu(Menu menu) { 
// 生成 菜单 ， 并 将 菜单 项 加 入 到 操作 栏 中 
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getMenuInfLater() .infLate(R.menu.menu main, menu); 
5 return true 


让 


- @Override 
- pubLic boolean on0ptionsItemSeLected(MenuItem item) { 
10 // 处 理 操作 栏 项 点 击 事件 。 只 要 你 在 AndroidManifest.XxmL 中 指定 了 父 活动 ， 
// 操作 栏 就 会 自动 处 理 主屏 幕 /向 上 按钮 点 击 事件 
int id = item.getItemId() ; 
- if (id == R.id.action settings) { 
1 和 return true; 
return super.onOptionsItemSelected(item); 


= 中 

这 些 方法 实现 了 一 个 Settings (设置 ) 菜单 ， 可 以 用 来 在 程序 中 添加 选项 。 例 如 ， 可 以 添加 
控制 位 置 更 新 频率 或 位 置 精度 的 选项 。 我 将 这 项 任务 作为 练习 留 给 你 去 完成 。 就 现在 而 言 保留 
这 些 方法 不 变 即 可 。 

















12.2.3 ”连接 到 位 置 提 供 器 


要 在 用 户 启动 该 应 用 或 从 其 他 应 用 切换 到 该 应 用 时 连 本 接 到 位 置 提 供 器 ， 并 在 用 户 从 该 应 用 切 
换 到 其 他 应 用 时 断 开 连接 。 在 方法 onResume() 和 onPause( ) 中 分 别 执行 这 些 操作 最 合适 

















locationTest/src/main/java/org/example/locationtest/MainActivity.java 
@Override 
protected void onResume() { 

super.onResume(); 

// 如 果 G00gLe Play 服 务 可 用 ,就 连接 到 客户 说 

if (servicesAvailable()) { 

mGoogleApiClient.connect(); 

} 

} 


@Override 
protected void onPause() { 
if (mGoogleApiClient.isConnected()) { 
mGoogleApiClient.disconnect(); 


} 


super.onPause(); 


} 

在 onResume ( ) 中 检查 Google Play 服 务 是 否 可 用 。 如 果 可 用 ， 就 对 前 面 在 方法 onCreate() 中 
创建 的 Google API 客 户 端 调用 方法 connect() 。 在 方法 onPause( ) 中 检查 是 否 连 接 到 了 Google 
API 客 户 端 。 如 果 连 接 到 了 Google API 客 户 端 ， 就 断 开 连接 。 

es ) 有 一 个 重要 的 副作用 : 成 功 建 立 连接 后 , 位置 服务 将 调用 你 的 类 的 方法 
onConnected() 。 下 面 演示 如 何 定 义 这 个 方法 。 
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locationTest/src/main/java/org/example/locationtest/MainActivity.java 

Line 1 /** 

- * 成 功 连 接 到 G00gle API 客 户 端 后 ， 位 置 服务 将 调用 这 个 方法 。 

- 米 在 这 个 方法 中 ， 你 可 以 请 求 当 前 位 置 或 启动 定期 更 新 

5 Ff/ 

- @Override 

- public void onConnected(Bundle dataBundle) { 

- // 显示 连接 状态 

- log("Connected"); 


3 // 获取 当前 位 置 
- Location location = LocationServices.FusedLocationApi.getLastLocation( 
- mGoogleApiClient); 
- log("Locations (starting with last known):"); 
15 if (location != null) { 
- dumpLocation(Location) ; 


方法 Log() 将 在 输出 视图 中 添加 一 行内 容 ， 并 向 上 滚动 输出 视图 。 方 法 dumpLocation() 用 
于 将 位 置 转换 为 字符 串 并 将 其 加 入 到 输出 视图 中 。 








locationTest/src/main/java/org/example/locationtest/MainActivity.java 
/** 将 一 个 字符 串 写 入 到 输出 窗口 中 */ 
private void Log(String string) { 
Long newTime = System.currentTimeMiLLis () ; 
mOutput.append(String.format("+%04d: %s\n", 
newTime - mLastTime, string)); 
mLastTime = newTime; 


// 将 文本 视图 滚动 到 末尾 的 小 窍门 
mScroller.post(new Runnable() { 
@Override 
public void run() { 
mScroller.fullScroll (View.FOCUS DOWN); 


}); 
} 


/# 六 描述 给 定 的 位 置 ， 它 可 能 为 null */ 
private void dumpLocation(Location location) { 


if (location == null) 
log("Location[unknown]"); 
else 


log(location.toString()); 
} 


注意 到 ,打印 每 条 日 志 消 息 前 都 会 获取 当前 时 间 , 并 将 其 与 前 一 次 的 时 间 相 减 ,在 行 首 打印 
时 间 差 。 
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12.2.4 获取 更 新 


当前 ， 这 个 程序 只 在 启动 时 显示 用 户 的 位 置 。 我 们 希望 它 频繁 地 打印 位 置 ( 这 样 在 用 户 移动 
时 , 日 志 将 越 来 越 长 )， 并 显示 用 户 经 过 的 所 有 位 置 。 为 此 ， 只 需 进 行 3 处 简单 修改 即 可 。 

首先 ， 在 方法 onConnected ( ) 的 末尾 调用 一 个 方法 ， 使 用 API 客 户 端 来 请 求 更 新 。 

代码 如 下 。 


























locationTest/src/main/java/org/example/locationtest/MainActivity.java 
public void onConnected(Bundle dataBundle) { 


// 请 求 高 精度 的 更 新 ， 更 新 间隔 为 1~5 秒 
LocationRequest locationRequest = LocationRequest.create(); 
locationRequest.setPriority(LocationRequest.PRIORITY HIGH ACCURACY); 
locationRequest.setInterval (UPDATE INTERVAL); 
locationRequest.setFastestInterval (FASTEST INTERVAL); 
LocationServices.FusedLocationApi.requestLocationUpdates( 
mGoogleApiClient, locationRequest, this); 
} 


在 这 个 示例 中 ,我 们 设置 了 精度 优先 于 电源 消耗 的 优先 级 ， 并 要 求 至 少 5 秒 更 新 一 次 。 如 引 
另 一 个 应 用 也 使 用 位 置 服 务 ， 但 获取 位 置 的 间隔 短 于 5 秒 ， 我 们 的 应 用 获取 更 新 的 频率 将 更 高 。 
然而 ， 我 们 还 设置 了 最 高 频率 ， 来 告诉 系统 ， 我 们 不 希望 每 秒 获 取 的 更 新 超过 一 


这 些 设 置 只 是 提示 。 系 统 会 尽 可 能 满足 你 的 愿望 ,但 为 了 节省 电量 ， 它 可 能 会 自作 主张 。 这 
意味 着 你 应 做 好 这 样 的 准备 ， To 能 比 你 要 求 的 高 或 低 。 运 行 这 个 应 用 时 ， 如 果 你 查看 
每 行 的 打印 时 间 ， 就 能 清楚 地 看 到 这 一 点 。 


有 更 新 可 用 时 ， 将 调用 方法 onLocationChanged( ) 。 





‘i 











< 


























locationTest/src/main/java/org/example/locationtest/MainActivity.java 

GOverride 

public void onLocationChanged(Location Location) { 
dumpLocation(Location) ; 





这 个 方法 只 是 用 来 将 位 置 打 印 到 日 志 视 图 。 


12.2.5 ”处 理 错误 


没有 Google Play Store 的 设备 ( 其 中 最 著名 的 是 Amazon Kindle Fire ) 没有 Google Play 服 务 。 
在 方法 onResume ( ) 中 ， 调 用 了 方法 servicesAvaitLabtLe() ， 用 来 检查 是 否 安装 了 Google Play 服 
务 ， 以 及 该 服务 是 否 是 最 新 的 。 这 个 方法 的 定义 如 下 。 
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locationTest/src/main/java/org/example/locationtest/MainActivity.java 
/** 检查 G00gLe Play 服 务 是 否 可 用 */ 
private boolean servicesAvailable() { 
int resultCode = GoogLePLayServicesUtit ， 
isGooglePlayServicesAvailable(this); 
if (ConnectionResult.SUCCESS == resultCode) { 
log("Google Play services is available"); 
return true; 
} elsef{ 
log("Google Play services is not available"); 
showErrorDialog(resultCode); 
return false; 


} 
如 果 Google Play 服 务 不 可 用 ， 就 调用 方法 showErrorDialog()。 














locationTest/src/main/java/org/example/locationtest/MainActivity.java 


/** 显示 一 条 G00gle Play 服 务 错误 消息 */ 
private void showErrorDialog(int resultCode) { 
// 从 Go0gle Play 服 务 获取 错误 对 话 框 
Dialog errorDialog = GooglePlayServicesUtil.getErrorDialog( 
resultCode, this, CONNECTION FAILURE RESOLUTION REQUEST); 


if (errorDialog != null) { 
// 显示 错误 
errorDialog.show(); 


} 

Google Play 服务 客户 端 库 提 供 了 一 个 创建 错误 对 话 框 以 将 错误 显示 给 用 户 的 函数 。 

连接 到 位 置 服务 时 也 可 能 发 生 错 误 。 建 立 连 接 可 能 会 需要 一 段 时 间 。 如 果 连 接 成 功 , 将 调用 
活动 的 方法 onConnected(); 如 果 连 接 失 败 ， 将 调用 方法 onConnectionFailed()。 








locationTest/src/main/java/org/example/locationtest/MainActivity.java 
* 如 果 在 试图 连接 到 位 置 客户 痛 时 以 失败 告终 ， 位 置 服务 将 调用 这 个 方法 
*/ 
Goverride 
public void onConnectionFailed(ConnectionResult connectionResult) { 
// 能 够 消除 错误 〈 如 通过 安装 新 版 本 ) 吗 
log("Connection failed"); 
if (connectionResult.hasResolution()) { 
try { 
// 启动 一 个 尝试 消除 错误 的 活动 
log("Trying to resolve the error..."); 
connectionResult.startResolutionForResult( 
this, CONNECTION FAILURE RESOLUTION REQUEST); 
} catch (IntentSender.SendIntentException e) { 
log("Exception during resolution: "+ e.toString()); 


} 
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} else{ 
// 没有 找到 错误 解决 方案 
showErrorDialog(connectionResult.getErrorCode()); 


} 


hag 
* 客户 端 暂 时 处 于 断 开 状 态 时 将 调用 这 个 方法 
*y 
@Override 
public void onConnectionSuspended(int cause) { 
log("Connection suspended"); 


} 

假设 有 Google Play 服务 可 用 ， 但 不 是 ( AndroidManifestxml 中 的 元 数据 ) 指定 的 版 本 。 在 这 
种 情况 下 ， 可 尝试 消除 错误 后 再 重 试 : 显示 一 个 对 话 框 ， 其 中 包含 一 个 让 用 户 前 往 Google Play 
Store 下 载 正确 版 本 的 选项 。 用 户 下 载 正确 的 版 本 后 ， 将 调用 方法 onActivityResult()。 








locationTest/src/main/java/org/example/locationtest/MainActivity.java 
/** 处 理 G00gLe PLay 服 务 错误 解决 结果 */ 
Goverride 
protected void onActivityResult(int requestCode, int resultCode, 
Intent data) { 
// 根据 原始 请 求 码 决定 处 理 方案 
Switch (requestCode) { 
case CONNECTION FAILURE RESOLUTION REQUEST: 
// 如 果 结 果 码 为 OK， 尝 试 再 次 连接 
log("Resolution result code is: " + resultCode); 
switch (resultCode) { 
case Activity.RESULT OK: 
// 尝试 再 次 连接 
GoogleApiClient.connect(); 
break ; 
} 


break ; 
} 
每 当 活 动 启动 男 一 个 活动 ， 并 希望 获得 返回 的 结果 时 ,都 将 调用 这 个 方法 。 因 此 ,首先 必须 
检查 请 求 码 是 否 与 onConnectionFailed() 中 设置 的 请 求 码 相 同 。 然 后 ,必须 检查 解决 方案 是 否 
管用 ( 结果 码 为 OK )。 如 果 这 两 个 条 件 都 满足 ， 就 可 以 尝试 再 次 连接 。 这 次 尝试 应 该 可 以 成 功 。 



































12.2.6 请求 权限 


最 后 一 步 是 ， 在 文件 AndroidManifestxml 中 的 标签 appLication 前 面 添加 如 下 代码 行 。 








locationTest/src/main/AndroidManifest.xml 


<uses-permission 
android:name="android.permission.ACCESS COARSE LOCATION" /> 
<uses-permission 
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android:name="android.permission.ACCESS FINE LOCATION" /> 


这 些 代 码 告诉 Android， 应 用 需要 访问 用 户 的 当前 位 置 才能 运行 。 





12.2.7 ”运行 


所 有 方法 都 定义 好 后 ， 编 辑 器 窗口 中 应 该 没有 任何 错误 。 运 行 这 个 程序 ,你 应 该 看 到 不 断 滚 
动 的 更 新 ， 如 图 12-2 所 示 。 请 注意 ， 这 个 程序 需要 有 位 置 提供 器 才能 运行 ， 因 此 必须 在 实际 设备 
上 运行 它 。 

注意 到 相 邻 日 志 项 的 时 间 间 隔 长 短 不 一 。 位 置 服务 会 尽 可 能 确保 间隔 为 1000~5000 毫 秒 ( 1~5 
秒 )， 但 并 非 总 能 成 功 。 

如 果 你 是 在 实际 设备 上 运行 该 应 用 ,请 将 设备 拔 下 来 , 并 带 着 它 出 去 溜达 一 会 儿 。 在 你 溜达 
时 ， 将 看 到 经 度 、 纬 度 和 精度 在 不 断 变化 。 

这 些 数 字 看 起 来 可 能 很 枯燥 , 但 有 了 它们 之 后 ， 就 可 以 随便 使 用 。 为 何不 使 用 Maps API 来 绘 
制 你 的 移动 轨迹 呢 ? 也 可 以 使 用 Geolocation API 来 显示 你 经 过 了 哪些 街道 。 甚 至 可 以 让 应 用 在 你 
接近 喜欢 的 咖啡 馆 时 提醒 你 。 所 有 这 些 功 能 都 可 以 使 用 Google API 并 编写 少量 代码 来 实现 。 

额外 练习 : 让 这 个 应 用 长 时 间 运 行 。 它 将 越 来 越 慢 ， 最 终 几 乎 没有 反应 。 请 找 出 原因 并 解决 
其 中 的 问题 。 
































12.3 ”快速 阅读 指南 
本 章 简 要 地 介绍 了 Google Play 服务 提供 的 激动 人 心 的 功能 。 我 们 创建 了 一 个 使 用 其 中 一 种 服 
位 置 服务 的 应 用 ， 但 这 只 是 皮毛 。 要 更 深入 地 了 解 Google Play 服务 ， 请 参阅 在 线 文档 "。 


本 书 还 有 一 童 就 结束 了 ,下 一 章 将 演示 如 何 使 用 SQL 在 手机 中 存储 结构 化 信息 , 如 包含 景点 、 
照片 和 说 明 的 旅行 日 志 。 





务 





CD http://d.android.com/google/play-services 
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过 去 30 年 来 ,数据 库 始 终 是 企业 应 用 程序 开发 的 主要 组 成 部 分 , 但 对 小 规模 应 用 而 言 ， 它 们 
太 过 昂贵 、 也 太 策 抽 了 。 近 年 来 ， 随 着 小 型 岩 入 式 引 擎 (如 Android 平 台 自 带 的 引擎 ) 的 推 
情况 发 生 了 变化 。 

本 章 演 示 如 何 使 用 Android 的 能 入 式 数 据 库 引 擎 SQLite ， 你 还 将 学 习 如 何 使 用 Android 数 据 绑 
定 功能 将 数据 源 关 联 到 用 户 界面 。 你 将 学 习 ContentProvider 类 ， 它 能 够 让 两 个 应 用 共享 数据 。 


可 以 使 用 内 容 提供 器 和 SQLite 在 应 用 中 存储 地 址 列表 、 订 单 、 棋 谱 以 及 众多 其 他 的 对 象 。 需 
要 在 跨 程 序 调用 中 传递 大 量 数据 项 时 ， 这 些 技术 都 将 派 上 用 场 。 

另外 ,本章 还 将 演示 如 何 使 用 Loader 类 来 确保 UI 响 应 迅速 而 流畅 。 如 果 不 使 用 加 载 器 
( loader ), 数据 库 访 问 和 其 他 长 时 间 运 行 的 任务 可 能 会 导致 用 户 界面 停顿 , 给 用 户 带 来 糟糕 的 体验 。 


EE 


















































13.1 ” SQLite 简介 


SQLite "是 一 个 功能 强大 的 微型 数据 库 引 擎 ， 由 Richard Hipp 博 士 于 2000 开 发 。SQLite 无 疑 是 
全 球 部 署 最 广泛 的 SQL 数据 库 引 擎 。 除 Android 外 ， 其 身影 还 出 现在 Apple iPhone 、Symbian 手 机 、 
Mozilla Firefox 、Skype、PHP、Adobe AIR、Mac OS X、Solaris 等 众多 地 方 。 








SQLite 许 可 


SQLite 源 代码 不 需要 许可 ， 因 为 它 不 受 版 权限 制 。SQLite 源 代码 不 但 不 需要 许可 ， 还 会 
像 下 面 这 样 祝 福 你 。 


愿 你 行善 莫 行 恶 





GD http:/www.sqlite.org 


图 灵 社 区 会 员 maik000 专 享 尊重 版 权 





13.2 SQL 基础 知识 153 








SQLite 为 何如 此 深 受 欢迎 呢 ? 下 面 是 其 中 的 3 个 原因 。 


口 它 是 免费 的 。 作 者 放弃 了 版 权 ， 不 对 用 户 收取 任何 费用 
口 它 很 小 。 最 新 版 本 为 130KB ， 在 Android 手 机 的 内 存 中 容纳 它 绰 绰 有 余 。 
口 它 不 需要 安装 和 管理 。 不 需要 服务 器 ， 没 有 配置 文件 ， 不 需要 数据 库 管理 员 。 


SQLite 数 据 库 就 是 一 个 文件 。 移 动 这 个 文件 ， 其 至 将 其 复制 到 其 他 系统 ( 例如 ,从 手机 复制 
到 工作 站 )， 它 依然 能 够 正常 运行 。Android 将 数据 库 文件 存 储 在 目录 /data/data/packagename/ 
databases 中 。 可 以 使 用 命令 adb 来 查看 、 移 动 和 删除 它 。 


要 在 程序 中 访问 这 个 文件 ， 需 要 运行 结构 化 查询 语言 (SQL ) 语句 ， 而 不 是 调用 Java IO 例 
程 。Android 通 过 辅助 类 和 便利 方法 隐藏 了 一 些 SQL 语法 , 但 要 使 用 SQLite, 还 是 需要 对 SQL 有 个 
大 致 了 解 。 





O 






































13.2 ”SQL 基础 知识 
如 果 你 使 用 过 Oracle、SQL Server、MySQL、DB2 或 其 他 数据 库 引 擎 ， 那 么 一 定 不 会 对 SQL 
感到 陌生 ， 可 以 直接 跳 到 13.3 节 ; 如 若 不 然 ， 则 可 通过 本 节 对 SQL 大 臻 有 个 了 解 。 


为 了 使 用 SQL 数 据 库 ， 需 要 提交 SQL 语 句 并 获取 返回 的 结果 。SQL 语 句 分 为 三 大 类 : DDL 语 
句 、 修 改 语句 和 查询 语句 。 








13.2.1 ”DDL 语句 


数据 库 文件 可 包含 很 多 表 。 表 由 行 组 成 ,其 中 每 行 包含 的 列 数 都 是 固定 的 。 表 的 每 列 都 有 名 
称 和 数据 类 型 ( 文本 字符 串 、 数 字 等 )。 首 先 ， 需 要 运行 数据 定义 语言 (DDL ) 语句 来 定义 这 些 
表 和 列 。 例 如 ， 下 面 的 语句 用 于 创建 一 个 包含 3 列 的 表 。 


























sqlite/create.sql 


create table mytable ( 
_id integer primary key autoincrement, 
name text, 
phone text ); 


其 中 一 列 被 指定 为 主键 一 一 唯一 标识 行 的 数字 。AUTOINCREMENT 意 味 着 每 添加 一 条 记录 , 数 
据 库 就 将 主键 加 1， 以 确保 每 条 记录 都 是 唯一 的 。 根 据 约 定 ， 第 一 列 总 是 被 命名 为 id。SQLite 
并 不 要 求 表 必 须 包 含 id 列 ， 但 后 面 使 用 Android 内 容 提 供 器 时 将 需要 它 。 

请 注意 , 不同 于 其 他 大 多 数 数据 库 ,， 在 SQLite 中 ， 列 类 型 只 是 提示 。 如 果 你 试图 在 整 型 列 中 
存储 字符 串 或 在 字符 串 列 中 存储 整 型 数据 , 不 会 导致 任何 错误 。SQLite 的 作者 将 此 视 为 一 种 特色 ， 
而 非 bug。 
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13.2.2 ”修改 语句 


SQL 提 供 了 很 多 让 你 能 够 在 数据 库 中 插入 、 删 除 和 更 新 记录 的 语句 。 例 如 ,要 添加 儿 个 电话 
号 码 ， 可 以 使 用 如 下 代码 。 








sqlite/insert.sql 


insert into mytable values(null, 'Steven King', '555-1212'); 
insert into mytable values(null, 'John Smith', '555-2345'); 
insert into mytable values(null, 'Fred Smitheizen', '555-4321'); 


值 的 排列 顺序 与 CREATE TABLE 语 句 中 列 的 排列 顺序 相同 。 这 里 将 _id 列 的 值 指 定 成 了 NULL， 
因为 SQLite 会 为 我 们 计算 该 列 的 值 。 
13.2.3 ”查询 语句 


在 表 中 添加 数据 后 ， 就 可 以 使 用 SELECT 语句 对 表 执 行 查 询 了 。 例 如 ， 要 获取 第 3 条 记录 ， 可 
以 采取 如 下 做 法 。 








sqlite/selectid.sql 


select * from mytable where( id=3); 


你 可 能 希望 根据 人 名 查询 电话 号 码 。 下 面 演示 如 何 查 找 所 有 姓名 中 包含 Smit 了 h 的 记录 。 

















sqlite/selectwhere.sql 


select name, phone from mytable where(name like "%smith%"); 


别 忘 了 SQL 不 区 分 大 小 写 。 无论 是 关键 字 、 列 名 还 是 搜索 字符 串 ， 都 可 指定 为 大 写 ， 也 可 指 
定 为 小 写 。 
对 SQL 有 足够 的 了 解 后 ， 下 面 来 看 看 如 何在 一 个 简单 程序 中 应 用 这 些 知 识 。 











13.3 ”一 个 简单 的 数据 库 程序 


为 演示 SQLite， 下 面 来 创建 一 个 简单 应 用 一 一 Events。 它 用 于 在 数据 库 中 存储 记录 ， 并 显示 
这 些 记录 ,首先 创建 一 个 简单 应 用 ,然后 不 断 添加 功能 。 在 新 建 项 目 向 导 中 ， 使 用 如 下 设置 来 新 
建 一 个 程序 。 
口 应 用 名 : Events 
口 公司 域名 : example.org 
口 尺寸 : Phone and Tablet 
口 最 低 SDK: API 16: Android 4.1 ( Jelly Bean ) 
口 添加 活动 : Blank Activity 
口 活动 名 : MainActivity 
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口 布局 名 : activity_main 
口 标题 : Events 








与 往常 一 样 ， 你 可 从 本 书 的 配套 网 站 "下 载 完整 的 源 代码 ( 查找 示例 eventsv1 )。 











这 里 需要 存储 一 些 描 述 数 据 库 的 常量 ， 为 此 要 创建 一 个 Constants 接 口 。 


eventsv1/src/main/java/org/example/events/Constants.java 


package org.exampLe.events ; 
import android.provider.BaseCoLumns ; 


public interface Constants extends BaseColumns { 


public static final String TABLE NAME 
// 数据 库 中 的 列 


= "events"; 


public static final String TIME = "time"; 


public static final String TITLE = "ti 





内 























tle"; 


个 事件 都 将 作为 一 行 存储 在 events 表 中 ， 每 行 都 包含 id、time 和 title 列 。 其 中 ， id 


是 主键 ， 它 是 在 扩展 的 接口 BaseCoLumns 中 定义 的 ; time 和 title 列 将 分 别 用 于 存储 时 间 惟 和 事 


件 名 称 。 


13.3.1 使 用 SQLite0penHeLper 








接 下 来 将 创建 一 个 名 为 EventsData 的 加 
创建 和 版 本 的 Android 类 SQLite0penHetLper 


> 


方法 。 





上 助 类 ， 用 来 表示 数据 库 本 身 。 它 扩展 了 管理 数据 库 
。 你 需要 做 的 只 是 提供 一 个 构造 函数 ， 并 重 写 两 个 








eventsv1/src/main/java/org/example/events/EventsData.java 


Line 1 package org.example.events; 


- import static android.provider.BaseColumns. ID; 
- import static org.example.events.Constants.TABLE NAME; 


u 


import static org.example.events.Constants.TIME; 


- import static org.example.events.Constants.TITLE; 


- import android.content.Context; 


- import android.database.sqlite.SQLiteDatabase; 
- import android.database.sqlite.SQLiteOpenHelper; 


- public class EventsData extends SQLite0penHeLper { 
private static final String DATABASE NAME = "events.db"; 
private static final int DATABASE VERSION = 1; 


15. /# 半 创建 一 个 表示 EVents 数 据 库 的 辅助 对 象 */ 
- public EventsData(Context ctx) { 


super(ctx, DATABASE NAME, null, DATABASE VERSION); 


} 





QD http://pragprog.com/book/eband4 
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20 GOverride 
public void onCreate(SQLiteDatabase db) { 
db.execSQL("CREATE TABLE " + TABLE NAME + " (" + _ID 
+ " INTEGER PRIMARY KEY AUTOINCREMENT, " + TIME 
+ " INTEGER," + TITLE + " TEXT NOT NULL);"); 
25 } 
@Override 
public void onUpgrade(SQLiteDatabase db, int oldVersion, 
int newVersion) { 
30 db.execSQL("DROP TABLE IF EXISTS " + TABLE NAME); 
onCreate (db); 
S } 
a 
构造 函数 始 于 第 16 行 。 其 中 ，DATABASE_NAME 是 要 使 用 的 数据 库 的 文件 名 ( events.db )， 
DATABASE_VERSION 是 虚构 的 编号 。 在 实际 程序 中 , 每 当 对 数据 库 设计 做 重大 修改 ( 如 添加 新 列 ) 
时 ， 都 需要 将 版 本 号 加 1。 























1 小 乔 爱 问 : 
过 ”为 何 将 Constants 声 明 为 接口 ? 


这 是 Java 的 特色 。 我 不 知道 你 ， 我 反正 不 喜欢 每 次 使 用 常量 时 都 必须 加 上 类 名 。 例 如 ， 
我 希望 只 输入 TIME,， 而 不 是 Constants.TIME。 传统 意 义 上 , 在 Java 中 可 以 使 用 接口 来 实现 
这 个 目的 。 类 可 以 继承 接口 Constants, 这 样 在 引用 该 接口 的 任何 字段 时 ,都 可 以 肖 略 接口 
名 。 如 果 你 查看 接口 BaseCoLumns ， 就 会 发 现 开发 Android 的 人 员 就 使 用 了 这 种 技巧 。 

然而 ， 从 Java5 起 ， 出 现 了 一 种 更 好 的 办 法 : 静态 导入 。 在 EventsData 以 及 本 章 的 其 


他 类 中 ， 我 就 使 用 了 这 种 办 法 。 由 于 Constants 是 一 个 接口 ， 因 此 可 以 使 用 新 方法 ， 也 可 
以 使 用 旧 方 法 ， 这 取决 于 你 的 喜好 。 

















数据 库 首次 被 访问 时 , SQLite0penHelper 会 发 现 它 是 不 存在 的 , 需要 调用 方法 onCreate() 
来 创建 它 。 第 21 行 重 写 了 方法 onCreate() ， 使 其 运行 一 条 CREATE TABLE SQL 语 句 。 这 将 创建 表 
events 以 及 包含 它 的 数据 库 文 件 events.db。 

当 Android ( 根据 版 本 号 ) 确定 你 引用 的 是 既 有 数据 库 时 ， 将 调用 方法 onUpgrade() (第 28 
行 )。 在 这 个 示例 中 ， 只 实现 了 将 旧 表 删除 的 操作 ， 如 果 你 愿意 ， 也 可 以 在 这 个 方法 中 采取 更 聪 
明 的 做 法 。 例 如 ， 可 以 运行 一 个 ALTER TABLE SQL 命令 ， 在 既 有 数据 库 中 添加 列 。 

















13.3.2 ”定义 主 程序 
写 程 序 Events 时 ， 一 开始 将 使 用 本 地 SQLite 数 据 库 来 存储 事件 ， 并 将 它们 以 字符 串 的 方式 








或 
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显示 在 TextView 中 。 


采取 如 下 方式 定义 布局 文件 layout/activity_main.xml。 


eventsv1/src/main/res/layout/activity_ main.xml 


<?xml version="1.0" encoding="utf-8"?> 
<ScrollView 
xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android:paddingLeft="@dimen/activity horizontal margin" 
android:paddingRight="@dimen/activity horizontal margin" 
android:paddingTop="@dimen/activity vertical margin" 
android:paddingBottom="@dimen/activity vertical margin" 
tools:context=",MainActivity"> 
<TextView 
android:id="@+id/text" 
android:layout width="match parent" 
android:layout height="wrap content" /> 
</ScrollView> 


这 里 声明 了 一 个 TextView ， 给 它 指 定 了 一 个 富有 想像 力 的 ID 一 text (在 代码 中 为 
R.id.text )， 再 将 它 放 在 一 个 scroLLView 中 ， 以 防 事件 太 多 而 无 法 在 屏幕 上 同时 显示 出 来 。 图 
13-1 所 示 的 屏幕 截图 说 明了 这 个 布局 的 效果 。 




















”AE 





Saved events: 

3:1426044425175: Hello, Android! 
2: 1426044412540: Hello, Android! 
1:1426044400980: Hello, Android! 





图 13-1 
主 程序 为 活动 MainActivity 的 方法 onCreate()， 其 轮廓 如 下 。 


eventsv1/src/main/java/org/example/events/MainActivity.java 


Line 1 package org.example.events; 


- import static android.provider.BaseColumns. ID; 

- import static org.example.events.Constants.TABLE NAME; 
5 import static org.example.events.Constants.TIME; 

- import static org.example.events.Constants.TITLE; 

- import android.app.Activity; 

import android.content.ContentValues; 

import android.database.Cursor; 
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10 import android.database.sqLite.SQLiteDatabase; 
- import android.os.Bundle; 
- import android.widget.TextView; 


- public class MainActivity extends Activity { 
15 private EventsData events; 
GOverride 
public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
setContentView(R.layout.activity main); 
20 events = new EventsData(this); 
try { 
addEvent ("Hello, Android!"); 
Cursor cursor = getEvents(); 
- showEvents (cursor) 
25 } finally { 
- events.close(); 


} 
= 


在 方法 onCreate() 中 , 第 19 行 用 来 设置 视图 的 布局 。 第 20 行 用 来 创建 一 个 EventsData 类 的 
实例 ， 然 后 是 一 个 try 块 。 如 果 你 往 下 看 第 26 行 ， 将 发 现在 finally 块 中 关闭 了 数据 库 。 这 样 ， 














即便 中 途 发 生 错误 ， 数 据 库 也 会 被 关闭 。 





如 果 不 Wr events 表 就 没有 多 大 意义 了 ， 因 此 第 22 行 调用 方法 addEvent ( 











) 在 这 


个 表 中 添加 了 一 个 事件 。 每 次 运行 这 个 程序 时 ,都 将 添加 一 个 事件 。 如 果 你 愿意 ,也 可 以 在 用 户 
选择 菜单 、 执 行 手 势 或 按键 时 添加 相应 的 事件 。 我 把 这 项 任务 作为 练习 留 给 你 去 完成 。 


























第 23 行 调用 方法 getEvents() 获 取 事 件 列表 。 最 后 ， 第 24 行 调用 方法 showEvents() 








显示 事件 列表 。 
非常 简单 ， 不 是 吗 ? 下面 来 定义 刚才 调用 的 新 方法 。 

















13.3.3 添加 记录 
方法 addEvent ( ) 在 数据 库 中 负责 添加 一 条 新 记录 ， 并 将 提供 的 字符 串 用 作 





eventsv1/src/main/java/org/example/events/MainActivity.java 


private void addEvent(String string) { 
// 在 数据 源 EVents 中 插入 一 条 新 记录 
// 你 将 执行 类 似 的 操作 来 删除 和 更 新 记录 
SQLiteDatabase db = events.getWritableDatabase(); 
ContentValues values = new ContentValues(); 
values.put(TIME, System.currentTimeMillis()); 
values.put(TITLE, string); 
db.insertOrThrow(TABLE NAME, null, values); 
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由 于 需要 修改 数据 , 因此 调用 方法 getWritableDatabase() 获 取 一 个 指向 数据 库 events 的 读 
写 句柄 。 该 数据 库 句柄 会 被 缓存 起 来 ， 因 此 想 调 用 这 个 方法 多 少 次 都 可 以 。 

接 下 来 ， 使 用 当前 时 间 和 事件 名 填充 一 个 ContentVatLues 对 象 ， 并 将 该 对 象 传递 给 方法 
insert0rThrow()， 让 它 执行 实际 的 INSERT SQL 语句 。 这 里 不 需要 传人 记录 ID ， 因 为 SQLite 会 
自动 创建 并 返回 一 个 ID。 


顾名思义 ， 如 果 失 败 ，insert0rThrow() 将 引发 类 型 为 SQLException 的 异常 。 无 需 使 用 关 
键 字 throws 来 声明 这 种 异常 ， 因 为 它 是 RuntimeException， 而 不 是 checked 异 常 。 然 而 ， 如 果 
你 愿意 ， 也 可 以 像 处 理 其 他 异常 那样 在 try/catch 块 中 处 理 它 。 发 生 错 误 时 ， 如 果 不 进行 任何 处 
理 ， 程 序 将 终止 ， 并 将 栈 跟踪 写 人 Android 日 志 。 


默认 情况 下 , 执行 插入 操作 后 , 数据 库 将 立即 更 新 。 如 果 要 以 批量 方式 进行 修改 或 延迟 修改 ， 
请 参阅 SQLite 网 站 了 解 详情 。 
























































13.3.4 ”运行 查询 
方法 getEvents ( ) 负 责 执行 数据 库 查 询 以 获取 事件 列表 。 








eventsv1/src/main/java/org/example/events/MainActivity.java 
private static String[] FROM = { _ID, TIME, TITLE, }; 
private static String ORDER BY = TIME + " DESC"; 
private Cursor getEvents() { 
// 执行 托管 查询 (managed query) ,活动 会 处 理 关闭 工作 ， 
// 并 在 必要 时 重新 查询 游标 
SQLiteDatabase db = events.getReadableDatabase(); 
Cursor cursor = db.query(TABLE NAME, FROM, null, null, null, 
null, ORDER BY); 
startManagingCursor(cursor); 
return cursor; 
} 
查询 时 不 需要 修改 数据 库 ， 因 此 调用 方法 getReadableDatabase( ) 来 获取 一 个 只 读 句 柄 。 
接 下 来 ， 调 用 query() 来 执行 实际 的 SELECT SQL 语 句 。FROM 是 一 个 数组 ， 指 定 了 要 检索 的 列 ， 


0RDER_BY 能 够 让 SQLite 按 从 新 到 旧 的 顺序 返回 结果 。 


方法 query() 还 有 用 于 指定 WHERE 子 句 、GROUP BY 子 句 和 HAVING 子 句 的 参数 ,但 这 个 示例 没 
有 使 用 它们 。 实 际 上 ，query () 的 目标 就 是 为 程序 员 提 供 方便 。 如 果 你 愿意 ， 也 可 以 以 字符 串 的 
方式 创建 SELECT 语句 ， 然 后 再 调用 方法 rawQuery() 来 执行 它 。 这 两 个 方法 都 返回 一 个 表示 结 
集 的 Cursor 对 象 。 

Cursor 类 似 于 Java Iterator 和 JDBC ResultSet。 可 以 对 其 调用 相应 的 方法 来 获取 有 关 当 前 
记录 的 信息 , 然后 调用 另 一 个 方法 来 移 到 下 一 条 记录 。 稍 后 在 显示 结果 时 , 你 将 看 到 使 用 Cursor 
的 方法 。 
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最 后 一 步 是 调用 startManagingCursor() ， 它 能 让 活动 根据 自己 的 生命 周期 来 管理 游标 的 
生命 周期 。 例 如 ， 活 动 暂停 时 ， 程 序 会 自动 将 游标 除 活 ; 而 活动 重新 启动 时 ,程序 又 将 重新 查询 
游标 ; 活动 终止 时 ， 程 序 将 关闭 所 有 托管 的 游标 。 


青 注意 ， 在 较 新 的 Android 版 本 中 ，startManagingCursor() 已 经 被 扎 弃 了 。 不 过 它 依然 管 
用 ， 只 是 还 有 更 佳 的 方式 ， 这 将 在 13.7 节 介绍 。 














、 


二 




















13.3.5 ”显示 查询 结果 


需要 定义 的 最 后 一 个 方法 是 showEvents ( ) ， 它 会 将 一 个 Cursor 对 象 作为 参数 ， 并 设置 输出 
的 格式 ， 以 方便 用 户 查看 。 








eventsv1/src/main/java/org/example/events/MainActivity.java 
Line1 private void showEvents(Cursor cursor) { 
// 将 要 显示 的 内 容 都 塞 到 一 个 字符 囊 中 
StringBuilder builder = new StringBuiLder( 
"Saved events:\n"); 
5 while (cursor.moveToNext()) { 
// 也 可 以 使 用 getCoLumnIndex0OrThrow() 来 获取 列 索 引 
Long id = cursor.getLong(0); 
Long time = cursor.getLong(1) 
- String title = cursor.getString(2); 
10 builder.append(id).append(": "); 
- builder.append(time).append(": "); 
builder.append(title).append("\n"); 
} 
// 显示 到 屏幕 上 
15 TextView text = (TextView) findViewById(R.id.text); 
- text.setText (builder); 
;让 
在 Events 示 例 的 这 个 版 本 中 ,创建 了 一 个 大 型 字符 串 ( 第 3 行 ) 来 存储 所 有 的 事件 记录 ， 并 
用 换行 符 分 隔 记 录 。 不 推荐 采用 这 种 做 法 ， 不 过 目前 它 还 是 可 行 的 。 


第 5 行 调用 方法 Cursor .moveToNext( ) 移 到 数据 集中 的 下 一 条 记录 。 刚 获取 的 Cursor 对 象 指 
向 第 一 条 记录 的 前 面 , 因 此 调用 moveToNext ( ) 将 移 到 第 一 条 记录 。 不 断 循环 , 直到 moveToNext () 
返回 false (表明 后 面 没 有 其 他 记录 ) 为 止 。 


在 循环 中 ,调用 getLong( ) 和 getString() 获 取 目 标 列 中 的 数据 (第 7~9 行 )， 再 将 它们 附加 
到 字符 串 的 未 尾 〈 第 10~12 行 )。Cursor 类 还 有 一 个 getColumnIndex0rThrow() 方 法 。 原 本 可 以 
使 用 它 来 获取 列 索引 号 (传递 给 getLong() 和 getString() 的 值 0?、1 和 2 )。 然 而 ， 这 个 方法 的 速 
度 有 点 慢 ， 因 此 如 果 需 要 ， 应 在 循环 外 调用 它 ， 并 将 返回 的 索引 号 存储 到 变量 中 。 


处 理 完 所 有 记录 后 ， 获 取 layoutactivity main.xml 中 定义 的 TextView， 并 将 前 面 创 建 的 大 型 
字符 串 加 入 其 中 ， 如 第 15~16 行 所 示 。 
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如 果 现 在 运行 这 个 示例 , 结果 将 类 似 于 图 13-1。 祝贺 你 , 已 经 创建 了 第 一 个 Android 数 据 库 程 
序 ! 但 它 需 要 改进 的 地 方 有 很 多 。 


如 果 有 数 千 乃至 数 百 万 个 事件 , 结果 将 如 何 呢 ?” 程 序 的 运行 速度 将 非常 慢 , 且 创 建 包含 所 有 
这 些 事件 的 字符 串 时 ,可 能 会 耗 尽 内 存 。 如 果 要 让 用 户 能 够 选择 并 处 理 一 个 事件 , 该 怎么 办 呢 ? 
如 果 将 全 部 事件 都 放 在 一 个 字符 串 中 , 就 无 法 提供 这 样 的 功能 。 好 在 Android 提供 了 更 佳 的 方式 : 
数据 绑 定 。 
































13.4 数据 绑 定 


数据 绑 定 只 需 让 你 编写 几 行 代码 就 能 将 模型 (数据 ) 关联 到 视图 。 为 了 演示 数据 绑 定 ,将 对 
前 面 的 Events 示 例 进 行 修改 ， 在 其 中 使 用 一 个 ListView， 并 将 其 绑 定 到 数据 库 查 询 结果 。 为 此 ， 
首先 让 MainActivity 类 扩展 ListActivity ( 而 不 是 Activity )。 














eventsv2/src/main/java/org/example/events/MainActivity.java 


import android.app.ListActivity; 


} 
接 下 来 ， 在 方法 MainActivity,showEvents () 中 修改 事件 的 显示 方式 。 





eventsv2/src/main/java/org/example/events/MainActivity.java 


import android.widget.SimpleCursorAdapter; 


private static int[] TO = { R.id.rowid, R.id.time, R.id.title, }; 
private void showEvents(Cursor cursor) { 
// 设置 数据 绑 定 
SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, 
R.layout.item, cursor, FROM, TO0); 
setListAdapter (adapter); 
} 
注意 到 ， 这 里 的 代码 比 以 前 少 得 多 ( 两 行 而 不 是 10 行 )。 第 1 行 根据 Cursor 创 建 一 个 
SimpleCursorAdapter, 第 2 行 让 ListActivity 使 用 这 个 新 的 适配器 。 适配器 充当 了 中 间 人 的 角色 ， 
将 视图 和 数据 源 关联 了 起 来 。 


你 可 能 还 记得 , 首次 使 用 适配器 是 在 第 11 章 的 Suggest 示 例 程 序 中 。 在 那个 示例 中 , 使 用 了 一 
个 ArrayAdapter ， 为 数据 源 是 在 XML 中 定义 的 数组 。 在 这 个 示例 中 ， 使 用 的 是 
SimpLeCursorAdapter， 因 为 数据 源 是 数据 库 查 询 返 回 的 Cursor 对 象 。 


SimpleCursorAdapter 的 构造 函数 接受 以 下 5 个 参数 。 
口 context: 指向 当前 活动 的 引用 。 
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口 Layout : 为 身 





个 列表 项 定义 视图 的 资源 。 





口 cursor: 数据 集 游标 。 
D from: 提供 数据 的 列 列表 。 
口 to: 显示 数据 的 视图 列表 。 


这 个 方法 在 较 新 的 Android 版 本 中 已 经 被 握 弃 了 ,但 目前 依然 管用 。 本 童 后 面 将 探索 其 闪 


列表 项 的 布局 是 在 layout/item.xml 中 定义 的 。 请 注 


的 定义 。 


eventsv2/src/main/ 


<?xml version="1 
<RelativeLayout 





res/layout/item.xml 


.0" encoding="utf-8"?> 


局 
性、 


数组 T0 引 用 的 视图 rowid、time 和 title 


xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent" 
android:orientation="horizontal" 
android:padding="10sp"> 


<TextView 


android:id="@+id/rowid" 
android:layout width="wrap_ content" 
android:layout height="wrap content" /> 


<TextView 


android:id="@+id/rowidcolon" 
android:layout width="wrap content" 
android:layout height="wrap_ content" 
android:text="; " 

android:layout toRight0f="@id/rowid" /> 


<TextView 


android:id="@+id/time" 
android:layout width="wrap_ content" 
android:layout height="wrap_content" 


android:layout toRight0f="@id/rowidcolon" /> 


<TextView 


android:id="@+id/timecolon" 
android:layout width="wrap _ content" 
android:layout height="wrap_content" 
android:text="; " 

android:layout toRight0f="@id/time" /> 


<TextView 


android:id="@+id/title" 

android:layout width="fill parent" 

android:layout height="wrap_content" 

android:ellipsize="end" 

android:singleLine="true" 

android:textStyle="italic" 

android:layout toRight0f="@id/timecolon" /> 
</RelativeLayout> 
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该 布局 看 起 来 比 实际 情况 复杂 。 它 只 是 将 ID 、 时 间 和 名 称 放 在 一 行 ,并 用 冒号 分 隔 它 们 。 为 
了 让 结果 看 起 来 更 漂亮 ， 我 指定 了 较 小 的 内 边 距 ， 并 设置 了 格式 。 


最 后 ， 需 要 在 layout/activity_main.xml 中 修改 活动 本 身 的 布局 。 修 改 后 的 版 本 如 下 。 


























eventsv2/src/main/res/layout/activity_main.xml 


<?xml version="1.0" encoding="utf-8"?> 
<LinearLayout 
xmlns:android="http://schemas.android.com/apk/res/android" 
android:layout width="fill parent" 
android:layout height="fill parent"> 
<!-- 请 注意 表示 “列表 ”和 “ 空 ”的 内 置 jd --> 
<ListView 
android:id="@Gandroid:id/list" 
android:layout width="wrap_ content" 
android:layout height="wrap_ content"/> 
<TextView 
android:id="@android:id/empty" 
android:layout width="wrap_ content" 
android:layout height="wrap_content" 
android:text="@string/empty" /> 
</LinearLayout> 


由 于 这 个 活动 扩展 了 ListAetivity，Android 将 在 布局 文件 中 查找 两 个 特殊 的 id。 如 果 列表 不 为 
空 ， 将 显示 视图 android:id/list; 否则 显示 视图 android:id/empty。 这 样 ， 没 有 列表 项 时 ， 用 户 看 到 
的 将 是 消息 “No events!”， 而 不 是 空 屏 幕 。 


下 面 是 需要 的 字符 串 资 源 。 





et 























eventsv2/src/main/res/values/strings.xml 


<?xml version="1.0" encoding="utf-8"?> 
<resources> 
<string name="app_name">Events</string> 
<string name="action settings">Settings</string> 
<string name="empty">No events!</string> 
</resources> 


最 终 的 结果 如 图 13-2 所 示 。 

作为 练习 ,请 你 想 想 如 何 改 进 这 个 使 用 了 列表 的 应 用 。 例如， 用户 选择 一 个 事件 时 ,可 以 打 
开 一 个 详细 视图 、 通 过 邮件 将 事件 发 送 给 技术 支持 或 将 选 定 事件 及 其 后 面 的 所 有 事件 都 从 数据 库 
中 删除 。 

这 个 示例 还 有 一 个 小 问题 : 其 他 应 用 无 法 写 和 人 事件 数据 库 , 甚至 都 无 法 查看 其 内 容 ! 为 了 解 
决 这 个 问题 ， 需 要 使 用 Android 内 容 提供 需 。 




















es 
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4: 1426044472600: Hello, Androidl 


3: 1426044425175: Hello, Android! 


2:1426044412540: Hello, Android! 


1: 1426044400980: Hello, Android! 














图 13-2 ”最 终结 果 一 一 使 用 ListActivity 和 数据 绑 定 





13.5 “使 用 内 容 提供 器 


在 Android 安 全 模型 中 ( 请 参阅 2.4 节 的 讨论 ), 一 个 应 用 写 入 的 文件 不 能 被 其 他 应 用 读 取 或 写 
入 。 每 个 程序 都 有 自己 的 Linux 用 户 ID、 数 据 目 录 ( /data/data/packagename ) 和 受 保护 的 内 存 空 间 。 
Android 程 序 可 以 如 下 两 种 方式 相互 通信 。 


口 进程 间 通 信 (IPC ): 进程 使 用 Android 接 口 定义 语言 (AIDL ) 和 IBinder 接 口 定义 API。 
调用 API 时 ， 会 在 进程 之 间 安 全 而 高 效 地 封 送 ( marshal ) 参数 。 这 种 高 级 技术 用 于 远程 调 
用 后 台 服 务 线程 。IPC、 服 务 和 binder 不 在 本 书 的 讨论 范围 内 。 要 更 详细 地 了 解 它 们 ， 请 
参阅 有 关 aidl”、 服 务 > 和 IBinder” 的 在 线 文档 。 

口 内 容 提供 器 : 在 系统 中 将 进程 注册 为 特定 数据 的 提供 侨 。 需 要 这 些 信 息 时 ，Android 通 过 
国定 的 API 调 用 进程 ， 以 进程 认为 合适 的 方式 查询 或 修改 内 容 。 将 在 Events 示 例 中 使 用 
种 技术 。 

内 容 提供 器 管理 的 信息 都 使 用 类 似 于 下 面 的 URI 进 行 编 址 。 

content://avuthority/path/id 

其 中 各 个 组 成 部 分 的 含义 如 下 。 

口 content:// 是 相应 标准 指定 的 必 不 可 少 的 前 级 。 

D authority 为 提供 器 的 名 称 。 为 避免 名 称 冲突 ， 建 议 使 用 全 限定 包 名 。 

D path 是 提供 器 中 的 虚拟 目录 ， 标 识 了 请 求 的 数据 类 型 。 

















Ce 



























































GD http://d.android.com/guide/components/aidl.html 
©® http://d.android.com/reference/android/app/Service.html 
@ http://d.android.com/reference/android/os/IBinder.html 
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口 id 是 请 求 的 特定 记录 的 主键 。 要 请 求 特定 类 型 的 所 有 记录 ， 可 省 略 该 it 和 末尾 的 斜 杠 。 
Android 提 供 了 多 种 内 置 提 供 器 ， 其 中 包括 : 


口 content://browser 





口 content://contacts 
口 content://media 
口 content://settings 


要 获悉 最 新 的 内 置 提供 器 清单 ， 请 参阅 在 线 文档 "。 访 问 这 些 提供 器 时 , 不 使 用 上 述 字符 串 ， 
而 使 用 Browser .BOOKMARKS_URI 等 常量 。 请 注意 ， 在 访问 某 些 提供 器 时 ， 必 须 在 清单 文件 中 请 
求 额外 的 权限 。 

为 了 演示 提供 器 的 用 法 , 下 面 修改 Events 示 例 , 在 其 中 使 用 提供 器 。 对 于 我 们 的 
下 面 是 一 些 有 效 的 URI。 


content://org.example.events/events/3 -- _ id 为 3 的 单个 事件 
content://org.example.events/events -- 所 有 事件 


首先 ， 需要 在 Constants.java 中 添加 两 个 常量 。 


























hl 





有 件 提供 器 ， 








eventsv3/src/main/java/org/example/events/Constants.java 
import android.net.Uri; 
VB 
public static final String AUTHORITY = "org.example.events"; 
public static final Uri CONTENT URI = Uri.parse("content://" 
+ AUTHORITY + "/" + TABLE NAME); 
不 需要 对 布局 文件 (activity_main.xml 和 item.xml ) 进行 修改 , 因此 下 一 步 是 对 MainActivity 


类 做 一 些 细微 的 修改 。 


13.5.1 修改 主 程序 
主 程序 (方法 MainActivity.onCreate() ) 实际 上 更 简单 ， 因 为 不 需要 跟踪 数据 库 对 象 。 








eventsv3/src/main/java/org/example/events/MainActivity.java 


@Override 

public void onCreate(Bundle savedInstanceState) { 
super.onCreate(savedInstanceState); 
SetContentView(R.Layout.activity main); 
addEvent("Hello, Android!"); 
Cursor cursor = getEvents(); 
showEvents (cursor); 








QD http://d.android.com/reference/android/provider/package-summary.html 
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这 里 不 再 需要 try/finally 块 ， 并 删除 了 指向 EventData 的 引用 。 


13.5.2 ”添加 记录 
在 addEvent () 中 ， 有 两 行 代码 是 不 同 的 ， 新 版 本 如 下 。 


eventsv3/src/main/java/org/example/events/MainActivity.java 
import static org.exampLe.events.Constants.CONTENT_URI; 
J ss 
private void addEvent(String string) { 
// 在 数据 源 Events 中 插入 一 条 新 记录 
// 你 将 执行 类 似 的 操作 来 删除 和 更 新 记录 
ContentValues values = new ContentValues(); 
values.put(TIME, System.currentTimeMillis()); 
values.put(TITLE, string); 
getContentResolver().insert(CONTENT URI, values); 
} 























这 里 不 再 需要 调用 getWritableDatabase()， 此 外 ， 应 调用 getContentResolver(). 
insert () 而 不 是 insert0rThrow() ， 并 传人 一 个 内 容 URI 而 不 是 数据 库 句 柄 。 




















13.5.3 ”运行 查询 





使 用 内 容 提供 器 时 ， 方 法 getEvents() 也 更 简单 了 。 


eventsv3/src/main/java/org/example/events/MainActivity.java 
private Cursor getEvents() { 

// 执行 托管 查询 。 活 动 会 处 理 关闭 工作 ， 

// 并 在 必要 时 重新 查询 游标 

return managedQuery(CONTENT_URI， FROM, null, null, ORDER BY); 
} 


这 里 调用 了 方法 Activity.managedQuery()， 并 传人 了 内 容 URI、 感 兴趣 的 列 列表 以 及 排 
序 方式 。 

通过 删除 所 有 数据 库 引 用 ， 实 现 了 Events 客 户 端 和 Events 数 据 提 供 器 之 间 的 解 厢 。 客 户 端 变 
得 更 简单 了 。 但 是 ， 接 下 来 必须 实现 以 前 没 实现 过 的 东西 。 
































13.6 ”实现 内 容 提 供 器 


内 容 提供 器 是 一 种 高 级 对 象 ， 与 活动 一 样 ， 必 须 向 系统 声明 。 因 此 ， 要 实现 内 容 提供 器 ， 首 
先 必须 在 文件 AndroidManifest.xml 中 声明 它 , 即 在 标签 <application> 中 标签 <activity> 的 前 面 
添加 如 下 标签 。 
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eventsv3/src/main/AndroidManifest.xml 


<provider 
android:name=".EventsProvider" 
android:authorities="org.example.events"/> 


其 中 ，android:name 是 类 名 (附加 在 包 名 后 面 )，android:authorities 是 用 于 内 容 URI 
中 的 字符 串 。 


接 下 来 ， 创 建 EventsProvider 类 。 这 个 类 必须 扩展 ContentProvider， 其 基本 轮廓 如 下 。 























eventsv3/src/main/java/org/example/events/EventsProvider.java 


package org.example.events; 


import static android.provider.BaseColumns. ID; 

import static org.example.events.Constants .AUTHORITY ; 
import static org.example.events.Constants.CONTENT _ URI; 
import static org.example.events.Constants.TABLE NAME; 
import android.content.ContentProvider; 

import android.content.ContentUris; 

import android.content.ContentValues; 

import android.content.UriMatcher; 

import android.database.Cursor; 

import android.database.sqlite.SQLiteDatabase; 

import android.net.Uri; 

import android.text.TextUtils; 


public class EventsProvider extends ContentProvider { 
private static finaL int EVENTS = 1; 
private static final int EVENTS ID = 2; 


/# 事件 目录 的 MIME 类 型 */ 
private static final String CONTENT TYPE 
= "vnd.android.cursor.dir/vnd.example.event"; 


/** 单个 事件 的 MIME 类 型 */ 
private static final String CONTENT ITEM TYPE 
= "vnd.android.cursor.item/vnd.example.event"; 


private EventsData events; 
private UriMatcher uriMatcher; 
jf wo 
} 
根据 约定 ， 要 在 MIME 类 型 中 使 用 vnd .example 而 不 是 org .example。 多 用 途 Internet 邮 件 扩 


展 类 型 ( MIME，Multipurpose Internet Mail Extensions ) 是 一 个 描述 内 容 类 型 的 Internet 标 准 。 
EventsProvider 可 以 处 理 两 种 类 型 的 数据 。 
口 EVENTS ( MIME 类 型 CONTENT TYPE ): 事件 目录 或 事件 列表 。 


口 EVENTS_ID ( MIME 类 型 CONTENT_ITEM_TYPE )， 单个 事件 。 | 
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就 URI 而 言 ， 差 别 在 于 第 一 种 类 型 不 指定 ID ， 而 第 二 种 类 型 可 以 指定 。 使 用 Android 类 

















UriMatcher 来 分 析 URI， 以 确定 客户 端 指定 的 是 哪 种 类 


面 的 EventsData 类 来 管理 实际 数据 库 。 








型 。 在 这 个 提供 顺 中 , 我 们 重 月 





目 了 本 音 前 


为 了 节省 篇 幅 , 这 里 没有 列 出 这 个 类 的 其 他 代码 , 你 可 以 从 本 书 的 配套 网 站 下 载 其 完整 源 代 
人 码 。Events 示 例 的 所 有 版 本 都 可 在 源 代码 ZIP 文 件 中 找到 。 





从 外 部 看 ，Events 示 例 的 这 个 版 本 与 前 一 个 版 本 完全 相同 , 但 在 内 部 ， 它 提供 了 一 个 事件 存 
储 框架 ， 可 供 系统 中 的 其 他 应 用 ， 乃 至 其 他 开发 人 员 编写 的 应 用 使 用 。 








13.7 ”使 用 加 载 器 





讨 


























写本 章 示 例 的 代码 时 ， 你 可 能 已 经 注意 到 ， 有 警告 指出 我 们 使 用 的 方法 managedQuery ( ) 


和 构造 函数 SimpLeCursorAdapter 都 已 经 被 气 弃 了 。 不 过 它们 依然 管用 ， 网 上 有 很 多 示例 都 在 
使 用 它们 。 然 而 ， 在 执行 长 时 间 运 行 的 操作 方面 ， 最 新 的 Android 版 本 提供 了 一 种 好 得 多 的 方式 : 


使 用 加 载 咒 。 
使 用 加 载 咒 的 方式 更 佳 的 原因 有 多 个 。 





停顿 或 断断续续 。 
口 它们 监视 数据 源 ， 在 数据 可 用 时 立即 提供 结果 ， 

















而 不 要 求 重新 查询 。 














口 它们 以 异步 方式 加 载 数据 。managedQuery() 在 UI 线程 中 加 载 数 据 ， 可 能 会 导致 用 户 界面 


口 它们 在 设备 配置 发 生变 化 时 保留 数据 ， 避 免 了 用 户 旋 转 屏 幕 或 暂停 应 用 时 重新 进行 查询 。 








为 了 使 用 加 载 器 ， 必 须 稍微 调整 本 章 应 用 的 结构 。 所 幸 需 要 做 的 所 有 修改 都 是 在 
MainActivity 类 中 进行 的 。 首 先 ， 在 开头 添加 几 条 ;import 语 句 ， 以 导入 所 需 的 类 。 





eventsv4/src/main/java/org/example/events/MainActivity.java 


import android.app.LoaderManager; 
import android.content.CursorLoader; 
import android.content.Loader; 





接 下 来 ， 修 改 MainActivity 类 ， 使 其 实现 接口 LoaderCaLLbacks， 并 声明 两 个 新 的 变量 。 


eventsv4/src/main/java/org/example/events/MainActivity.java 


public class MainActivity extends ListActivity impLements 


LoaderManager.LoaderCaLLbacks<Cursor> { 


// 当前 活动 中 加 载 器 独一无二 的 ID 
private final static int LOADER ID = 1; 


// 将 数据 绑 定 到 ListView 的 适配器 
private SimpleCursorAdapter mAdapter; 
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然后 ， 删 除 方法 getEvents() 和 showEvents()， 因 为 已 经 不 再 需要 它们 了 。 将 方法 
onCreate( ) 修 改 成 如 下 形式 。 











eventsv4/src/main/java/org/example/events/MainActivity.java 


@Override 
public void onCreate(Bundle savedInstanceState) { 


} 





个 适 配 右 一 开始 为 空 ， 


super.onCreate(savedInstanceState); 
SetContentView(R.Layout.activity main); 


// 初始 化 适配器 。 它 一 开始 为 空 
mAdapter = new SimpleCursorAdapter(this, 


// 将 适配器 关联 到 ListView 
setListAdapter (mAdapter); 


// 初始 化 加 载 器 
LoaderManager lm = getLoaderManager(); 


lm.initLoader(LOADER ID, null, this); 


addEvent("Hello, Android!"); 











R.layout.item, null, FROM, TO, 0); 





在 方法 onCreate( ) 中 创建 适 配 带 ， 并 将 其 关联 到 列表 视图 ， 而 不 是 等 到 以 后 再 这 样 做 。 这 
但 后 面 将 使 用 方法 addEvent () 在 其 中 添加 一 个 事件 。 接 下 来 ， 获 取 一 个 





指向 加 载 需 管理 器 的 句柄 ， 并 初始 化 一 个 加 载 需 。 


给 方法 initLoader() 传 递 的 最 后 一 个 参数 为 this ， 它 指向 刚才 修改 为 实现 了 接口 
LoaderCallbacks 的 MainActivity 类 。 因 此 ， 接 下 来 需要 实现 这 个 接口 定义 的 3 个 必 不 可 少 
的 方法 。 





eventsv4/src/main/java/org/example/events/MainActivity.java 


@Override 
public Loader<Cursor> onCreateLoader(int id, Bundle args) { 


} 


// 创建 一 个 CursorLoader 对 象 


return new CursorLoader(this, CONTENT URI, FROM, null, null, ORDER BY); 


@Override 
public void onLoadFinished(Loader<Cursor> loader, Cursor cursor) { 


switch (loader.getId()) { 
case LOADER ID: 


// 数据 可 用 
mAdapter.swapCursor(cursor); 
break ; 
} 
} 
@Override 


public void onLoaderReset(Loader<Cursor> loader) { 


// 加 载 器 的 数据 不 可 用 
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mAdapter.swapCursor(null); 


} 


第 一 个 方法 (onCreateLoader() ) 在 需要 创建 新 的 加 载 器 时 被 调用 ， 它 只 负责 创建 并 返 
一 个 新 的 CursorLoader 对 象 。 

方法 onLoadFinished() 在 加 载 器 填充 好 游标 时 被 调用 。 游 标 填 充 好 后 ， 就 可 以 将 其 换 入 适 
配器 ， 让 适配器 (及 其 关联 的 列表 ) 开始 显示 新 数据 。 

最 后 , 方法 onLoaderReset ( ) 在 加 载 器 中 没有 数据 时 被 调用 , 因为 必须 用 不 包含 任何 数据 的 
空 游 标 换 出 原来 的 游标 。 

现在 运行 这 个 程序 时 ， 外 观 几乎 与 以 前 完全 相同 。 这 个 应 用 的 运行 速度 原本 就 非常 快 ， 因 此 
几乎 看 不 出 有 什么 差别 。 但 请 相信 我 ， 要 创建 流畅 而 不 是 断断续续 的 应 用 ， 务 必 将 数据 库 查 询 、 
网 络 WO、 计 算 以 及 任何 耗 时 的 操作 移出 主 GUI 线 程 。 





回 


















































13.8 快速 阅读 指南 


在 本 章 中 ， 你 学 习 了 如 何在 Android SQL 数据 库 中 存储 数据 。 要 使 用 SQL 实现 更 多 的 功能 ， 
必须 学 习 本 章 未 介绍 的 其 他 语句 和 表达 式 。 为 此 ， 购 买 Jonathan Gennick 编 著 的 SOL Pocket Guide 
[Gen10] 或 Mike Owens 编 写 的 《SQLite 权 威 指南 》( The Definitive Guide to SOLite ) [AO10] 会 是 不 
错 的 选择 。 但 别 忘 了 ， 在 不 同 的 数据 库 引擎 中 ，SQL 语 法 和 函数 存在 细微 的 差别 。 


可 以 对 本 章 介 绍 的 SimpLeCursorAdapter 进 行 定制 ， 以 显示 除 文本 外 的 其 他 内 容 。 例 如 ， 
可 根据 Cursor 对 象 中 的 数据 显示 星 级 、 迷 你 图 (小 型 图 表 ) 或 其 他 视图 。 有 关 这 方面 的 更 详细 
信息 ， 请 参阅 SimpLeCursorAdapter 文 档 " 中 的 ViewBinder。 


使 用 加 载 器 并 非 改 善 应 用 性 能 的 唯一 途径 。 例 如 ， 在 第 11 章 中 ， 我 们 就 使 用 了 Executor 和 
Runnable 类 在 独立 的 线程 中 执行 网 络 1/O 操 作 。 


对 Android 的 简要 介绍 到 这 里 就 结束 了 。 为 了 让 你 接 下 来 的 旅程 更 加 顺利 ， 务 必 查 看 本 书 配 
套 网 站 “提供 的 资源 和 源 代码 。 另 外 ， 在 Stack Overflow 网 站 ”的 Android 频 道 ， 还 可 找到 很 多 问题 
的 答案 


口外 o 


现在 就 去 打造 卓越 的 应 用 吧 ! 





























De 
































GD http://d.android.com/reference/android/widget/SimpleCursorA dapter.html 
©® http://pragprog.com/book/eband4 
© http://stackoverflow.com/questions/tagged/android 
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附录 
Java 和 Android 在 语言 和 
API 方 面 的 异同 











从 很 大 程度 上 说 ，Android 程 序 是 使 用 Java 语 言 编写 的 , 使 用 的 是 Java 6 Standard Edition ( SE ) 
库 API。 这 里 之 所 以 说 “从 很 大 程度 上 说 ”， 是 因为 还 存在 一 些 不 同 之 处 。 本 附录 介绍 常规 Java 和 
Android 使 用 的 Java 之 间 的 差别 。ART ( Android 5.0 和 更 高 版 本 使 用 的 运行 时 系统 ) 和 Dalvik 
( Android 5.0 之 前 的 版 本 使 用 的 运行 时 系统 ) 也 存在 这 样 的 限制 。 


如 果 你 熟悉 其 他 平台 上 的 Java 开 发 ， 应 仔细 研究 本 附录 ， 以 了 解 需 要 将 哪些 功能 抛 诸 脑 后 。 




















A.1 语言 子 集 


Android 使 用 标准 Java 编 译 需 将 源 代 人 码 编译 成 常规 的 字 节 码 , 然后 将 这 些 字 节 码 转换 为 要 执行 
的 指令 。 因 此 ，Android 几 乎 全 面 支持 Java 语 言 ， 而 不 仅仅 是 其 一 小 部 分 。 通 过 使 用 编译 器 和 字 节 
人 码 ， 在 应 用 中 使 用 库 时 ， 通 常 不 需要 获取 其 源 代码 。 





























A.1.1 语言 等 级 


Android Studio 支 持 与 Java Standard Edition 6 或 更 早 版 本 兼容 的 代码 ， 还 可 支持 Java 7 新 增 的 
功能 ， 但 当前 不 支持 任何 Java 8 功能 。 
要 支持 Java 7 语言 功能 ， 需 要 在 gradle 编 译文 件 中 添加 如 下 代码 行 。 


compileOptions { 
sourceCompatibility JavaVersion.VERSION 1 7 
targetCompatibility JavaVersion.VERSION 1 7 
} 


这 能 够 让 你 在 针对 Android 2.2( Froyo ) 和 更 高 版 本 的 应 用 中 使 用 Java 7 的 如 下 语言 功能 : 
口 钻石 运算 符 ( <> ) 

口 在 switch 语 句 中 使 用 字符 串 

D 在 一 条 catch 语 句 中 捕获 多 种 异常 (catch (Excl | Exc2 e) ) 
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口 在 数字 字面 量 中 使 用 下 划 线 (1.234_567 ) 
口 二 进 制 字面 量 (0b1110111 ) 
这 还 能 够 让 你 在 针对 Android 4.4 (KitKat ) 和 更 高 版 本 的 应 用 中 使 用 如 下 功能 : 


D try-with-resources 语 句 
口 @GSafeVarargs 注 解 


当然 ， 要 解锁 这 些 功 能 ， 必 须 安 装 Java 7 或 更 高 版 本 的 JDK。 








A.1.2 内置 类 型 


支持 所 有 的 Java 内 置 类 型 , 包括 byte、 char、 short、 int、 long、 float、 double、 0bject、 
String 和 数组 。 在 较 旧 的 低 端 硬件 上 ， 可 能 会 模拟 浮 点 数 数学 运算 。 这 意味 着 ,涉及 double 或 
float 的 运算 将 在 软件 而 不 是 硬件 中 执行 ,因此 速度 比 整数 算术 运算 慢 得 多 ,然而 , 较 新 的 Android 
设备 都 装备 了 优秀 的 浮 点 硬件 ， 因 此 这 通常 不 是 问题 。 














A.1.3 ”多 线程 和 同步 


多 线程 是 通过 时 际 技术 实现 的 ,依次 给 每 个 线程 若干 毫秒 的 运行 时 间 , 然后 执行 上 下 文 切换 ， 
让 男 一 个 线程 执行 。 虽然 Android 支 持 任意 数量 的 线程 ， 但 一 条 经 验 规则 是 ， 线 程 数 不 应 超过 设 
备 的 处 理 右 核 数 加 1。 一 个 线程 专用 于 主 用 户 界面 ( 如 果 有 的 话 )， 其 他 线程 用 于 执行 长 时 间 运 行 
的 操作 ， 如 计算 或 网 络 1/O。 

例如 ， 在 四 核 设备 上 运行 时 ， 将 总 线程 数 限制 为 5， 可 让 应 用 获得 最 佳 的 性 能 。 要 获悉 设备 
的 处 理 器 核 数 ， 可 使 用 函数 Runtime.getRuntime().avaiLabteProcessors()。 

Android 实 现 了 关键 字 synchronized 以 及 与 同步 相关 的 库 方 法 ， 如 Object.wait() 、 
0bject.notify() 和 0bject.notifyAll()。 它 还 为 支持 复杂 算法 提供 了 java.util.concurrent 包 。 
要 让 多 个 线程 互 不 干扰 ， 可 像 在 其 他 Java 程 序 中 那样 使 用 它们 。 























A.1.4 反射 

虽然 Android 平 台 支 持 Java 反 射 , 但 并 不 应 该 使 用 它 , 尤其 是 在 对 时 间 敏感 的 代码 中 。 其 中 的 
原因 很 简单 : 为 了 改善 性 能 和 节省 电量 。 因 为 反射 的 速度 很 慢 ， 而 速度 缓慢 的 代码 会 消耗 更 多 的 
电量 。 可 以 考虑 使 用 替代 品 ， 如 编译 阶段 工具 和 预 处 理 器 。 

















A.1.5 终结 


维和 





像 常 规 Java VM 一 样 ，Android 支 持 在 垃圾 收集 阶段 终结 对 象 。 然 而 ， 大 多 数 Java 专 家 都 建议 
不 要 依赖 于 终结 器 〈finalizer )， 因 为 它们 是 否 会 运行 以 及 何 时 运行 都 是 不 确定 的 。 应 使 用 显 式 方 
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法 close() 或 terminate()。Android 用 于 资源 有 限 的 硬件 中 ,因此 必须 立即 释放 不 再 需要 的 资源 。 
这 一 点 很 重要 。 


A.2 标准 库 子 集 


Android 支 持 一 个 相对 较 大 的 Java Standard Edition 6.0 库 子 集 。 有 些 API 不 支持 是 因为 它们 不 
适用 ， 还 有 一 些 不 支持 是 因为 有 更 好 的 专用 于 Android 的 API。 前 面 说 过 ，Android 4.4 (KitKat ) 
和 更 高 版 本 支持 一 些 Java 7 新 增 的 功能 ， 包 括 AutoClosable 接 口 和 @SafeVarargs 注 解 。 然 而 ， 
它们 通常 不 支持 Java 7 和 Java 8 新 增 的 库 API， 包 括 新 的 文件 系统 API (NIO 2.0 )、Fork 和 Join 以 及 


invokedynamic。 















































A.2.1 支持 的 包 


Android 支 持 如 下 标准 包 。 要 获悉 如 何 使 用 它们 ,请 参阅 Java 2 Platform Standard Edition 6.0 API 
文档 "。 


口 java.awt.font: 一 些 与 Unicode 和 字体 相关 的 常量 。 

D java.beans: 一 些 修改 JavaBeans 属 性 的 类 和 接口 。 

口 java.io: 文件 和 流 LIO。 

口 java.lang (java.lang.management 除 外 ): 语言 和 异常 支持 。 

口 java.math: 大 数 、 圆 整 和 精度 。 

D java.net: 网 络 IO 、URL 和 套 接 字 。 

D java.nio: 文件 和 通道 WO。 

口 java.security: 授权 、 证 书 和 公 钥 。 

口 java.sql: 数据 库 接口 。 

口 java.text: 格式 设置 、 自 然 语言 和 排序 规则 ( collation )。 

D javautil ( 包括 java.util.concurrent ): 列表 、 映 射 、 集 、 数 组 和 
口 javax.crypto: 加 密 算 法 和 公 钥 。 

口 javax.microedition.khronos: OpenGL 图 形 (来 自 Java Micro Edition )。 

D javax.net: 套 接 字 工厂 和 SSL。 

口 javax.security (javax.security.auth.kerberos、 javax.security.auth.spi 和 和 javax.security.sasl 除 外 )。 
口 javax.sql (javax.sql.rowset 除 外 ): 数据 库 接口 。 

口 javax.xmlparsers: XML 分 析 。 

D org.w3c.dom (不 包括 子 包 ): DOM 节 点 和 元 素 。 

DD org.xml.sax: Simple API forXML。 





























? Ly 


J 
口 o 











QD http://docs.oracle.com/javase/6/docs/api/ 
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请 注意 ， 虽 然 也 支持 常规 Java SQL 数据 库 API ( JDBC )， 但 不 应 使 用 它们 来 访问 本 地 SQLite | 
数据 库 ， 而 使 用 android.database API ( 参见 第 13 章 )。 








A.2.2 不 支持 的 包 
Android 不 支持 Java 2 Platform Standard Edition 中 的 下 述 包 : 


口 java.applet 

口 java.awt 

口 java.lang.management 
口 java.rmi 

口 javax.accessibility 

口 javax.activity 

口 javax.imageio 

口 javax.management 

口 javax.naming 

口 javax.print 

口 javax.rmi 

口 javax.security.auth.kerberos 
口 javax.security.auth.spi 
口 javax.security.sasl 

口 javax.sound 

口 javax.swing 

口 javax.transaction 

口 javax.xml (javax.xml.parsers 除 外 ) 
DD org.ietf.* 

DQ org.omg.* 

口 org.w3c.dom.* ( 子 包 ) 





A.3 第 三 方 库 


为 方便 开发 人 员 使 用 ， 除 前 面 列 出 的 标准 库 外 ，Android SDK 还 自 带 了 多 个 第 三 方 库 。 


口 org.json: JavaScript 对 象 表示 法 ( JavaScript Object Notation )。 
口 org.xml.sax: XML 分 析 。 
口 org.xmlpull.v1: XML 分 析 。 
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“Ed 再 次 向 初中 级 Android 开 发 人 员 推 出 了 一 部 精巧 的 学 习 指 南 。 这 部 指南 实用 且 引 人 入 胜 ， 适 
合 刚 步 入 Android 应 用 开发 领域 的 人 员 阅 读 ， 也 可 供 有 一 定 经 验 ， 欲 更 深入 地 了 解 基 本 游戏 开发 、 动 
画 、 音 效 、 线 程 、 数 据 库 和 Google Play 服务 等 概念 的 人 员 参 考 。” 

一 一 Diego Torres Milano， 技 术 发 烧 友 、Android 系 统 工 程 师 、Linux 拥 征 、 作 者 


“在 引领 读者 初 识 Android 应 用 开发 方面 ， 其 他 图 书 难以 与 之 比肩 ! ” 
一 一 Mark Murphy，CommonsWare 创 始 人 ， 
The Busy Coder's Guide to Android Development 的 作者 


“以 令 人 愉悦 的 写作 风格 ， 通 过 引人入胜 的 示例 ， 简 了 明 扼 要 地 曾 述 了 大 量 基础 知识 ， 适 合 所 有 想 
快速 掌握 Android 开 发 的 人 员 阅 读 。” 
一 一 Jason Pike，theswiftlearner.com 软 件 开发 人 员 


“介绍 Play Store 的 一 章 表 明 ， 将 应 用 提交 到 这 个 应 用 商店 易如反掌 ， 真 是 令 人 醒 一 灌顶 。” 
一 一 Stephen Wolf，Max Gate Digital 有 限 公司 董事 


“这 本 书 非常 易 读 易 懂 ， 有 关于 正确 编程 方法 的 精美 图 片 、 细 节 和 小 提示 。 时 至 今日 ， 我 想 它 仍 
然 是 关于 Android 的 优秀 图 书 之 一 。 这 本 书 不 是 给 编程 新 手 看 的 ， 而 是 给 Android 编 程 新 手 看 的 。” 
一 一 Amazon.com 读 者 评论 


“最 开始 拿 到 这 本 书 时 我 其 实 并 不 知道 其 中 的 内 容 ， 是 非常 技术 性 还 是 连 门外汉 也 能 看 懂 ? 令 我 
吃惊 的 是 它 二 者 兼 具 。 出 于 一 些 原 因 ， 我 十 分 想 开发 出 自己 的 Android 应 用 程序 。 这 本 书 帮 有 我 商定 了 
基础 ， 而 且 借 助 示例 一 步 步 地 讲解 ， 让 整个 开发 过 程 易 于 理解 和 实践 。” 

一 一 Amazon.com 读 者 评论 
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